Darwin

Per accedere all'API relativa a Darwin è necessario che sia presente lo scope darwin nel token. Inoltre possono accedere all'API gli utenti appartenenti ai seguenti gruppi:

admin
domain
darwin

L'utente appartenente al gruppo darwin ha un accesso limitato alle sole richieste che gli vengono assegnate dall'utente amministratore (gruppo admin).

Per un dettaglio puntuale dei metodi e delle risorse disponibili si veda anche la documentazione OpenAPI.

Warning

L'API di Darwin non è al momento disponibile nella piattaforma di test (pubtest).

Panoramica

L'API Darwin consente al Registrar di lavorare sulle procedure segnalate dal Registro relative ad anomalie sui contatti registranti. Permette di gestire le richieste aperte, i contatti e i domini coinvolti, le anomalie rilevate, gli eventi di lavorazione, i documenti richiesti e gli eventuali aggiornamenti proposti per il contatto di riferimento.

Il flusso tipico è il seguente:

ricercare le richieste Darwin disponibili;
prendere in carico o assegnare una richiesta;
consultare il contatto di riferimento, i contatti collegati, i domini, le anomalie e gli eventi;
caricare i documenti richiesti ed eventualmente inserire un aggiornamento dei dati del contatto;
validare i dati inseriti e processare la richiesta.

Stati e valori utili

Stati della richiesta

I possibili valori del campo status di una richiesta Darwin sono:

submitted
pending
rejected
registrarUpdated
processing
processingExpired
expired
completed
processingCancelled
cancelled

Stati di un contatto Darwin

I possibili valori del campo status di un contatto Darwin sono:

submitted
rejected
locked
processed

Azioni sui contatti

I possibili valori del campo action sono:

Codice	Descrizione
todo	Contatto selezionato per essere modificato
hold	Contatto che non verrà aggiornato e i domini collegati saranno messi in `serverHold`
delete	Contatto che verrà eliminato e così anche i domini collegati

Stati di assegnazione

Per filtrare le richieste tramite il parametro registrarAssignation sono disponibili i seguenti valori:

all
assigned
unassigned
assignedToMe

Tipi di documento

I possibili valori del campo documentType sono:

Codice	Descrizione
`IC`	Carta d'identità
`PASS`	Passaporto
`FC`	Codice Fiscale
`CHAMBER`	Visura Camerale
`DEED`	Atto Costitutivo
`CERT`	Certificato Attribuzione P.IVA
`OTHER`	Altro

Tipi di anomalia

I possibili codici restituiti nel campo codes delle anomalie Darwin sono:

Codice	Descrizione
`1010`	Classifier predicted bad registrant organization name
`1020`	Language impossible to detect for registrant organization
`1030`	Language inconsistent with the nationality field
`1040`	Language inconsistent with the country field
`1050`	Person name similar to a company name
`1060`	Person name inconsistent with Fiscal Code
`1070`	Name inconsistent with VAT validation
`1080`	Org value set NOT OK by an operator
`2010`	Nationality must be equal to country
`2020`	Nationality set NOT OK by an operator
`3010`	Classifier predicted bad registrant address
`3020`	Language impossible to detect for registrant address
`3030`	Registrant address not found
`3040`	Address inconsistent with the country code
`3050`	Address inconsistent with VAT validation
`3060`	Address set NOT OK by an operator
`4010`	Irregular Fiscal Code or VAT number
`4020`	VIES check failed
`4021`	VAT number not found
`4022`	VAT name anomaly
`4023`	VAT address anomaly
`4030`	Many different registrants with this regcode
`4040`	F.C. or VAT number set NOT OK by an operator

Richieste Darwin

Cercare le richieste

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/requests

Permette di ottenere l'elenco paginato delle richieste Darwin. I filtri disponibili sono:

Parametro	Descrizione
`referenceContactOrg`	ricerca per organizzazione del contatto di riferimento (startsWith)
`referenceContactRegcode`	ricerca per codice identificativo del contatto di riferimento
`registrarAssignation`	filtra per stato di assegnazione
`status`	filtra per stato della richiesta
`page`	pagina dei risultati, default `0`
`size`	numero di elementi per pagina, default `20`
`view`	aggiunge informazioni extra; i valori ammessi sono `referenceContact` e `expirationDays`, separati da virgola

HTTPcURL

GET /v1/darwin/requests?status=pending&registrarAssignation=assignedToMe&view=referenceContact,expirationDays HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "elements" : [ {
    "id" : 125,
    "registrarId" : 10,
    "status" : "pending",
    "statusDate" : "2024-04-10T09:14:21+02:00",
    "created" : "2024-04-08T11:30:00+02:00",
    "expirationDays" : 5,
    "referenceContact" : {
      "contactId" : 101,
      "requestId" : 125,
      "registrarContactId" : "C-1001",
      "dbnaId" : 998877,
      "org" : "Example S.r.l.",
      "regcode" : "RSSMRA80A01H501Z"
    }
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

curl "https://api.nic.it/v1/darwin/requests?status=pending&registrarAssignation=assignedToMe&view=referenceContact,expirationDays" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "elements" : [ {
    "id" : 125,
    "registrarId" : 10,
    "status" : "pending",
    "statusDate" : "2024-04-10T09:14:21+02:00",
    "created" : "2024-04-08T11:30:00+02:00",
    "expirationDays" : 5,
    "referenceContact" : {
      "contactId" : 101,
      "requestId" : 125,
      "registrarContactId" : "C-1001",
      "dbnaId" : 998877,
      "org" : "Example S.r.l.",
      "regcode" : "RSSMRA80A01H501Z"
    }
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

I risultati della ricerca sono paginati.

Contare le richieste

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/requests/count

Restituisce il numero di richieste che soddisfano gli stessi filtri disponibili nella ricerca.

HTTPcURL

GET /v1/darwin/requests/count?status=pending&registrarAssignation=assigned HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "count" : 12
}

curl "https://api.nic.it/v1/darwin/requests/count?status=pending&registrarAssignation=assigned" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "count" : 12
}

Ottenere le richieste in scadenza

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/requests/expiring?days={days}

Restituisce l'elenco paginato delle richieste in scadenza entro il numero di giorni indicato da days. Sono disponibili gli stessi filtri di ricerca relativi al contatto di riferimento e allo stato di assegnazione.

HTTPcURL

GET /v1/darwin/requests/expiring?days=7&registrarAssignation=assignedToMe&view=referenceContact,expirationDays HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "elements" : [ {
    "id" : 125,
    "registrarId" : 10,
    "status" : "pending",
    "statusDate" : "2024-04-10T09:14:21+02:00",
    "created" : "2024-04-08T11:30:00+02:00",
    "expirationDays" : 5,
    "referenceContact" : {
      "contactId" : 101,
      "requestId" : 125,
      "registrarContactId" : "C-1001",
      "dbnaId" : 998877,
      "org" : "Example S.r.l.",
      "regcode" : "RSSMRA80A01H501Z"
    }
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

curl "https://api.nic.it/v1/darwin/requests/expiring?days=7&registrarAssignation=assignedToMe&view=referenceContact,expirationDays" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "elements" : [ {
    "id" : 125,
    "registrarId" : 10,
    "status" : "pending",
    "statusDate" : "2024-04-10T09:14:21+02:00",
    "created" : "2024-04-08T11:30:00+02:00",
    "expirationDays" : 5,
    "referenceContact" : {
      "contactId" : 101,
      "requestId" : 125,
      "registrarContactId" : "C-1001",
      "dbnaId" : 998877,
      "org" : "Example S.r.l.",
      "regcode" : "RSSMRA80A01H501Z"
    }
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

I risultati della ricerca sono paginati.

Contare le richieste in scadenza

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/requests/expiring/count?days={days}

Restituisce il numero di richieste in scadenza entro il numero di giorni indicato.

HTTPcURL

GET /v1/darwin/requests/expiring/count?days=7&registrarAssignation=assignedToMe HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "count" : 3
}

curl "https://api.nic.it/v1/darwin/requests/expiring/count?days=7&registrarAssignation=assignedToMe" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "count" : 3
}

Ottenere una richiesta per identificativo

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/requests/{requestId}

Restituisce il dettaglio della richiesta. Anche in questo caso il parametro facoltativo view permette di includere referenceContact e expirationDays.

HTTPcURL

GET /v1/darwin/requests/125?view=referenceContact,expirationDays HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id" : 125,
  "registrarId" : 10,
  "status" : "pending",
  "statusDate" : "2024-04-10T09:14:21+02:00",
  "note" : "Verifica dati anagrafici del registrante",
  "created" : "2024-04-08T11:30:00+02:00",
  "expirationDays" : 5,
  "referenceContact" : {
    "contactId" : 101,
    "requestId" : 125,
    "registrarContactId" : "C-1001",
    "dbnaId" : 998877,
    "org" : "Example S.r.l.",
    "regcode" : "RSSMRA80A01H501Z"
  },
  "requiredDocuments" : {
    "documents" : [ "IC", "FC" ]
  },
  "registrarUser" : {
    "id" : 123,
    "username" : "darwin.user",
    "name" : "Mario Rossi"
  }
}

curl "https://api.nic.it/v1/darwin/requests/125?view=referenceContact,expirationDays" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "id" : 125,
  "registrarId" : 10,
  "status" : "pending",
  "statusDate" : "2024-04-10T09:14:21+02:00",
  "note" : "Verifica dati anagrafici del registrante",
  "created" : "2024-04-08T11:30:00+02:00",
  "expirationDays" : 5,
  "referenceContact" : {
    "contactId" : 101,
    "requestId" : 125,
    "registrarContactId" : "C-1001",
    "dbnaId" : 998877,
    "org" : "Example S.r.l.",
    "regcode" : "RSSMRA80A01H501Z"
  },
  "requiredDocuments" : {
    "documents" : [ "IC", "FC" ]
  },
  "registrarUser" : {
    "id" : 123,
    "username" : "darwin.user",
    "name" : "Mario Rossi"
  }
}

Ottenere le anomalie di una richiesta

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/requests/{requestId}/anomalies

Restituisce l'elenco delle anomalie associate alla richiesta. Ogni anomalia contiene:

field: campo anomalo;
codes: lista dei codici di anomalia;
contacts: eventuale elenco dei contatti coinvolti.

HTTPcURL

GET /v1/darwin/requests/125/anomalies HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

[ {
  "field" : "registrant.regcode",
  "codes" : [ 4010, 4030 ],
  "contacts" : [ "C-1001", "C-1002" ]
} ]

curl "https://api.nic.it/v1/darwin/requests/125/anomalies" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

[ {
  "field" : "registrant.regcode",
  "codes" : [ 4010, 4030 ],
  "contacts" : [ "C-1001", "C-1002" ]
} ]

Ottenere il contatto di riferimento scelto

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/requests/{requestId}/referenceContact

Restituisce i dati del contatto scelto come riferimento per la richiesta: identificativi Darwin e DBNA, registrarContactId, organizzazione e codice identificativo.

HTTPcURL

GET /v1/darwin/requests/125/referenceContact HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "contactId" : 101,
  "requestId" : 125,
  "registrarContactId" : "C-1001",
  "dbnaId" : 998877,
  "org" : "Example S.r.l.",
  "regcode" : "RSSMRA80A01H501Z"
}

curl "https://api.nic.it/v1/darwin/requests/125/referenceContact" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "contactId" : 101,
  "requestId" : 125,
  "registrarContactId" : "C-1001",
  "dbnaId" : 998877,
  "org" : "Example S.r.l.",
  "regcode" : "RSSMRA80A01H501Z"
}

Ottenere i giorni mancanti alla scadenza

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/requests/{requestId}/expirationDays

Restituisce il numero di giorni mancanti alla scadenza della richiesta.

HTTPcURL

GET /v1/darwin/requests/125/expirationDays HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "count" : 5
}

curl "https://api.nic.it/v1/darwin/requests/125/expirationDays" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "count" : 5
}

Prendere in carico una richiesta

1.0 | darwin | admin / domain |

POST https://api.nic.it/v1/darwin/requests/{requestId}/assignToMe

Assegna la richiesta all'utente autenticato. Il metodo può restituire 409 Conflict se la richiesta è già assegnata oppure se il suo stato non è compatibile con l'operazione.

HTTPcURL

POST /v1/darwin/requests/125/assignToMe HTTP/1.1
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 204 No Content

curl -X POST "https://api.nic.it/v1/darwin/requests/125/assignToMe" \
-H "Authorization: Bearer token..."

Assegnare una richiesta a un utente

1.0 | darwin | admin |

POST https://api.nic.it/v1/darwin/requests/{requestId}/assignToUser

Permette a un utente admin di assegnare la richiesta a uno specifico utente Darwin tramite il payload seguente:

{
  "userId" : 123
}

HTTPcURL

POST /v1/darwin/requests/125/assignToUser HTTP/1.1
Content-Type: application/json
Host: api.nic.it
Authorization: Bearer token...

{
  "userId" : 123
}

HTTP/1.1 204 No Content

curl -X POST "https://api.nic.it/v1/darwin/requests/125/assignToUser" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer token..." \
-d '{
  "userId" : 123
}'

Rilasciare l'assegnazione

1.0 | darwin | admin / domain |

POST https://api.nic.it/v1/darwin/requests/{requestId}/assignationRelease

Rilascia l'assegnazione della richiesta. Il metodo può restituire 409 Conflict se la richiesta non risulta assegnata oppure se il suo stato non è compatibile con l'operazione.

HTTPcURL

POST /v1/darwin/requests/125/assignationRelease HTTP/1.1
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 204 No Content

curl -X POST "https://api.nic.it/v1/darwin/requests/125/assignationRelease" \
-H "Authorization: Bearer token..."

Processare una richiesta

1.0 | darwin | admin / domain / darwin |

POST https://api.nic.it/v1/darwin/requests/{requestId}/process

Avvia l'elaborazione della richiesta e restituisce lo stato aggiornato della risorsa. In caso di dati mancanti o incoerenti il servizio restituisce 400 Bad Request.

HTTPcURL

POST /v1/darwin/requests/125/process HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id" : 125,
  "registrarId" : 10,
  "status" : "processing",
  "statusDate" : "2024-04-10T10:02:11+02:00",
  "created" : "2024-04-08T11:30:00+02:00"
}

curl -X POST "https://api.nic.it/v1/darwin/requests/125/process" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "id" : 125,
  "registrarId" : 10,
  "status" : "processing",
  "statusDate" : "2024-04-10T10:02:11+02:00",
  "created" : "2024-04-08T11:30:00+02:00"
}

Contatti Darwin

Cercare i contatti

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/contacts

Permette di cercare i contatti Darwin collegati alle richieste, con i filtri seguenti:

Parametro	Descrizione
`action`	filtra per azione (`todo`, `hold`, `delete`)
`dbnaId`	identificativo numerico del contatto in DBNA
`registrarContactId`	identificativo del contatto assegnato dal Registrar
`requestId`	identificativo della richiesta Darwin
`page`	pagina dei risultati, default `0`
`size`	numero di elementi per pagina, default `20`

Ogni elemento contiene, tra gli altri, id, dbnaId, requestId, registrarContactId, action, status e il flag reference.

HTTPcURL

GET /v1/darwin/contacts?requestId=125&action=todo&page=0&size=20 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "elements" : [ {
    "id" : 101,
    "dbnaId" : 998877,
    "requestId" : 125,
    "registrarContactId" : "C-1001",
    "action" : "todo",
    "status" : "submitted",
    "reference" : true
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

curl "https://api.nic.it/v1/darwin/contacts?requestId=125&action=todo&page=0&size=20" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "elements" : [ {
    "id" : 101,
    "dbnaId" : 998877,
    "requestId" : 125,
    "registrarContactId" : "C-1001",
    "action" : "todo",
    "status" : "submitted",
    "reference" : true
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

I risultati della ricerca sono paginati.

Contare i contatti

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/contacts/count

Restituisce il numero totale dei contatti che soddisfano i filtri di ricerca.

HTTPcURL

GET /v1/darwin/contacts/count?requestId=125&action=todo HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "count" : 4
}

curl "https://api.nic.it/v1/darwin/contacts/count?requestId=125&action=todo" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "count" : 4
}

Ottenere un contatto

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/contacts/{contactId}

Restituisce il dettaglio del contatto Darwin.

HTTPcURL

GET /v1/darwin/contacts/101 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id" : 101,
  "dbnaId" : 998877,
  "requestId" : 125,
  "registrarContactId" : "C-1001",
  "action" : "todo",
  "status" : "submitted",
  "reference" : true
}

curl "https://api.nic.it/v1/darwin/contacts/101" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "id" : 101,
  "dbnaId" : 998877,
  "requestId" : 125,
  "registrarContactId" : "C-1001",
  "action" : "todo",
  "status" : "submitted",
  "reference" : true
}

Modificare l'azione di un contatto

1.0 | darwin | admin / domain / darwin |

PATCH https://api.nic.it/v1/darwin/contacts/{contactId}

Permette di modificare l'azione associata a un singolo contatto:

{
  "action" : "hold"
}

HTTPcURL

PATCH /v1/darwin/contacts/101 HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

{
  "action" : "hold"
}

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id" : 101,
  "dbnaId" : 998877,
  "requestId" : 125,
  "registrarContactId" : "C-1001",
  "action" : "hold",
  "status" : "submitted",
  "reference" : true
}

curl -X PATCH "https://api.nic.it/v1/darwin/contacts/101" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer token..." \
-d '{
  "action" : "hold"
}'

{
  "id" : 101,
  "dbnaId" : 998877,
  "requestId" : 125,
  "registrarContactId" : "C-1001",
  "action" : "hold",
  "status" : "submitted",
  "reference" : true
}

Modificare in blocco l'azione dei contatti di una richiesta

1.0 | darwin | admin / domain / darwin |

PUT https://api.nic.it/v1/darwin/contacts/changeAction/request/{requestId}

Applica la stessa azione a tutti i contatti collegati alla richiesta indicata.

HTTPcURL

PUT /v1/darwin/contacts/changeAction/request/125 HTTP/1.1
Content-Type: application/json
Host: api.nic.it
Authorization: Bearer token...

{
  "action" : "hold"
}

HTTP/1.1 200 OK

curl -X PUT "https://api.nic.it/v1/darwin/contacts/changeAction/request/125" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer token..." \
-d '{
  "action" : "hold"
}'

Ottenere le anomalie di un contatto

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/contacts/{contactId}/anomalies

Se il parametro facoltativo all=true è presente, il servizio restituisce sia le anomalie generali sia quelle specifiche del contatto.

HTTPcURL

GET /v1/darwin/contacts/101/anomalies?all=true HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

[ {
  "field" : "email",
  "codes" : [ 3010 ]
}, {
  "field" : "registrant.regcode",
  "codes" : [ 4010 ],
  "contacts" : [ "C-1001" ]
} ]

curl "https://api.nic.it/v1/darwin/contacts/101/anomalies?all=true" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

[ {
  "field" : "email",
  "codes" : [ 3010 ]
}, {
  "field" : "registrant.regcode",
  "codes" : [ 4010 ],
  "contacts" : [ "C-1001" ]
} ]

Ottenere i dati DBNA del contatto

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/contacts/{contactId}/dbna

Restituisce i dati del contatto così come presenti in DBNA.

HTTPcURL

GET /v1/darwin/contacts/101/dbna HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id" : 998877,
  "name" : "Mario Rossi",
  "org" : "Example S.r.l.",
  "contactId" : "C-1001",
  "consentForPublish" : true,
  "email" : "info@example.it",
  "voice" : "+39.0612345678",
  "streets" : [ "Via Roma 1" ],
  "city" : "Roma",
  "postalCode" : "00100",
  "state" : "RM",
  "country" : "it",
  "registrant" : {
    "regcode" : "RSSMRA80A01H501Z",
    "nationality" : "it",
    "entityType" : 1
  },
  "status" : "ok / linked",
  "linked" : true
}

curl "https://api.nic.it/v1/darwin/contacts/101/dbna" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "id" : 998877,
  "name" : "Mario Rossi",
  "org" : "Example S.r.l.",
  "contactId" : "C-1001",
  "consentForPublish" : true,
  "email" : "info@example.it",
  "voice" : "+39.0612345678",
  "streets" : [ "Via Roma 1" ],
  "city" : "Roma",
  "postalCode" : "00100",
  "state" : "RM",
  "country" : "it",
  "registrant" : {
    "regcode" : "RSSMRA80A01H501Z",
    "nationality" : "it",
    "entityType" : 1
  },
  "status" : "ok / linked",
  "linked" : true
}

Aggiornamenti dati del contatto

Gli aggiornamenti dei dati del contatto permettono di proporre una nuova versione dei dati anagrafici da associare alla richiesta Darwin.

Il payload di contactData contiene i seguenti campi principali:

name
org
streets da 1 a 3 valori
city
state
postalCode
country (non modificabile dal Registrar)
voice
fax
email
consentForPublish
registrant.regcode

I campi registrant.nationality e registrant.entityType sono in sola lettura.

Elencare gli aggiornamenti di una richiesta

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/contactUpdates?requestId={requestId}

Restituisce tutti gli aggiornamenti inseriti per la richiesta.

HTTPcURL

GET /v1/darwin/contactUpdates?requestId=125 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

[ {
  "id" : 501,
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  },
  "created" : "2024-04-10T09:30:00+02:00"
} ]

curl "https://api.nic.it/v1/darwin/contactUpdates?requestId=125" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

[ {
  "id" : 501,
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  },
  "created" : "2024-04-10T09:30:00+02:00"
} ]

Ottenere l'aggiornamento corrente

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/contactUpdates/current?requestId={requestId}

Restituisce l'ultimo aggiornamento inserito per la richiesta.

HTTPcURL

GET /v1/darwin/contactUpdates/current?requestId=125 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id" : 501,
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  },
  "created" : "2024-04-10T09:30:00+02:00"
}

curl "https://api.nic.it/v1/darwin/contactUpdates/current?requestId=125" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "id" : 501,
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  },
  "created" : "2024-04-10T09:30:00+02:00"
}

Ottenere un aggiornamento per identificativo

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/contactUpdates/{contactUpdateId}

Restituisce il dettaglio di un aggiornamento specifico.

HTTPcURL

GET /v1/darwin/contactUpdates/501 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id" : 501,
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  },
  "created" : "2024-04-10T09:30:00+02:00"
}

curl "https://api.nic.it/v1/darwin/contactUpdates/501" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "id" : 501,
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  },
  "created" : "2024-04-10T09:30:00+02:00"
}

Creare un aggiornamento

1.0 | darwin | admin / domain / darwin |

POST https://api.nic.it/v1/darwin/contactUpdates

Esempio di payload:

{
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  }
}

Il servizio restituisce 201 Created con l'aggiornamento creato. In caso di stato non compatibile della richiesta viene restituito 409 Conflict.

HTTPcURL

POST /v1/darwin/contactUpdates HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

{
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  }
}

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id" : 501,
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  },
  "created" : "2024-04-10T09:30:00+02:00"
}

curl -X POST "https://api.nic.it/v1/darwin/contactUpdates" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer token..." \
-d '{
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  }
}'

{
  "id" : 501,
  "requestId" : 125,
  "message" : "Aggiornamento dati richiesto dal registrante",
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  },
  "created" : "2024-04-10T09:30:00+02:00"
}

Validare i dati di un aggiornamento

1.0 | darwin | admin / domain / darwin |

POST https://api.nic.it/v1/darwin/contactUpdates/validate

Valida il payload di un aggiornamento senza creare nuove risorse. In caso di esito positivo restituisce 204 No Content.

HTTPcURL

POST /v1/darwin/contactUpdates/validate HTTP/1.1
Content-Type: application/json
Host: api.nic.it
Authorization: Bearer token...

{
  "requestId" : 125,
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  }
}

HTTP/1.1 204 No Content

curl -X POST "https://api.nic.it/v1/darwin/contactUpdates/validate" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer token..." \
-d '{
  "requestId" : 125,
  "contactData" : {
    "name" : "Mario Rossi",
    "org" : "Example S.r.l.",
    "streets" : [ "Via Roma 1" ],
    "city" : "Roma",
    "state" : "RM",
    "postalCode" : "00100",
    "country" : "IT",
    "voice" : "+39.0612345678",
    "email" : "info@example.it",
    "consentForPublish" : true,
    "registrant" : {
      "regcode" : "RSSMRA80A01H501Z"
    }
  }
}'

Domini Darwin

Cercare i domini

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/domains

Permette di cercare i domini coinvolti in una o più richieste Darwin. I filtri disponibili sono:

contactId
dbnaId
domain
registrarContactId
requestId
page
size

HTTPcURL

GET /v1/darwin/domains?requestId=125&registrarContactId=C-1001 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "elements" : [ {
    "id" : 301,
    "dbnaId" : 778899,
    "domain" : "example.it",
    "registrarContactId" : "C-1001",
    "requestId" : 125,
    "contactId" : 101,
    "status" : "locked"
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

curl "https://api.nic.it/v1/darwin/domains?requestId=125&registrarContactId=C-1001" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "elements" : [ {
    "id" : 301,
    "dbnaId" : 778899,
    "domain" : "example.it",
    "registrarContactId" : "C-1001",
    "requestId" : 125,
    "contactId" : 101,
    "status" : "locked"
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

I risultati della ricerca sono paginati.

Contare i domini

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/domains/count

Restituisce il numero totale dei domini che soddisfano i filtri indicati.

HTTPcURL

GET /v1/darwin/domains/count?requestId=125 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "count" : 2
}

curl "https://api.nic.it/v1/darwin/domains/count?requestId=125" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "count" : 2
}

Ottenere un dominio

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/domains/{id}

Restituisce il dettaglio di un dominio Darwin, incluso lo stato (locked, incompatible, rejected, processed).

HTTPcURL

GET /v1/darwin/domains/301 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id" : 301,
  "dbnaId" : 778899,
  "domain" : "example.it",
  "registrarContactId" : "C-1001",
  "requestId" : 125,
  "contactId" : 101,
  "status" : "locked"
}

curl "https://api.nic.it/v1/darwin/domains/301" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "id" : 301,
  "dbnaId" : 778899,
  "domain" : "example.it",
  "registrarContactId" : "C-1001",
  "requestId" : 125,
  "contactId" : 101,
  "status" : "locked"
}

Ottenere i dati DBNA di un dominio

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/domains/{id}/dbna

Restituisce i dati del dominio così come presenti in DBNA.

HTTPcURL

GET /v1/darwin/domains/301/dbna HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id" : 778899,
  "domain" : "example.it",
  "status" : "ok / clientUpdateProhibited",
  "signed" : false,
  "registrantId" : 998877,
  "created" : "2023-04-16T11:24:20+02:00",
  "lastupdate" : "2024-04-16T11:24:20+02:00",
  "expire" : "2025-04-16T23:59:59+02:00",
  "registered" : true
}

curl "https://api.nic.it/v1/darwin/domains/301/dbna" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "id" : 778899,
  "domain" : "example.it",
  "status" : "ok / clientUpdateProhibited",
  "signed" : false,
  "registrantId" : 998877,
  "created" : "2023-04-16T11:24:20+02:00",
  "lastupdate" : "2024-04-16T11:24:20+02:00",
  "expire" : "2025-04-16T23:59:59+02:00",
  "registered" : true
}

Documenti Darwin

Cercare i documenti

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/documents

Permette di cercare i documenti caricati per le richieste Darwin usando i filtri:

documentType
requestId
page
size

HTTPcURL

GET /v1/darwin/documents?requestId=125&documentType=IC HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "elements" : [ {
    "id" : "a1b2c3",
    "requestId" : 125,
    "fileName" : "documento-identita.pdf",
    "fileSize" : 248392,
    "documentType" : "IC",
    "fileType" : "pdf",
    "note" : "Documento del registrante",
    "created" : "2024-04-10T09:45:00+02:00"
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

curl "https://api.nic.it/v1/darwin/documents?requestId=125&documentType=IC" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "elements" : [ {
    "id" : "a1b2c3",
    "requestId" : 125,
    "fileName" : "documento-identita.pdf",
    "fileSize" : 248392,
    "documentType" : "IC",
    "fileType" : "pdf",
    "note" : "Documento del registrante",
    "created" : "2024-04-10T09:45:00+02:00"
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

I risultati della ricerca sono paginati.

Contare i documenti

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/documents/count

Restituisce il numero totale dei documenti trovati.

HTTPcURL

GET /v1/darwin/documents/count?requestId=125 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "count" : 1
}

curl "https://api.nic.it/v1/darwin/documents/count?requestId=125" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "count" : 1
}

Ottenere un documento

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/documents/{documentId}

Restituisce i metadati del documento, tra cui fileName, fileSize, documentType, fileType, note e created.

HTTPcURL

GET /v1/darwin/documents/a1b2c3 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id" : "a1b2c3",
  "requestId" : 125,
  "fileName" : "documento-identita.pdf",
  "fileSize" : 248392,
  "documentType" : "IC",
  "fileType" : "pdf",
  "note" : "Documento del registrante",
  "created" : "2024-04-10T09:45:00+02:00"
}

curl "https://api.nic.it/v1/darwin/documents/a1b2c3" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "id" : "a1b2c3",
  "requestId" : 125,
  "fileName" : "documento-identita.pdf",
  "fileSize" : 248392,
  "documentType" : "IC",
  "fileType" : "pdf",
  "note" : "Documento del registrante",
  "created" : "2024-04-10T09:45:00+02:00"
}

Creare un documento

1.0 | darwin | admin / domain / darwin |

PUT https://api.nic.it/v1/darwin/documents

Crea un nuovo documento per una richiesta Darwin. Il file caricato deve avere application/pdf o image/jpeg come content type. In caso di file troppo grande il servizio restituisce 413 Request Entity Too Large. Per il dettaglio del payload di upload e dei campi richiesti si rimanda alla documentazione OpenAPI della specifica operazione.

HTTPcURL

PUT /v1/darwin/documents HTTP/1.1
Content-Type: multipart/form-data; boundary=------------------------abcdef1234567890
Host: api.nic.it
Authorization: Bearer token...

--------------------------abcdef1234567890
Content-Disposition: form-data; name="document"
Content-Type: application/json

{
  "requestId" : 125,
  "documentType" : "IC",
  "note" : "Documento del registrante"
}
--------------------------abcdef1234567890
Content-Disposition: form-data; name="file"; filename="documento-identita.pdf"
Content-Type: application/pdf

...binary content...
--------------------------abcdef1234567890--

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id" : "a1b2c3",
  "requestId" : 125,
  "fileName" : "documento-identita.pdf",
  "fileSize" : 248392,
  "documentType" : "IC",
  "fileType" : "pdf",
  "note" : "Documento del registrante",
  "created" : "2024-04-10T09:45:00+02:00"
}

curl -X PUT "https://api.nic.it/v1/darwin/documents" \
-H "Authorization: Bearer token..." \
-F 'document={"requestId":125,"documentType":"IC","note":"Documento del registrante"};type=application/json' \
-F "file=@documento-identita.pdf;type=application/pdf"

{
  "id" : "a1b2c3",
  "requestId" : 125,
  "fileName" : "documento-identita.pdf",
  "fileSize" : 248392,
  "documentType" : "IC",
  "fileType" : "pdf",
  "note" : "Documento del registrante",
  "created" : "2024-04-10T09:45:00+02:00"
}

Eliminare un documento

1.0 | darwin | admin / domain / darwin |

DELETE https://api.nic.it/v1/darwin/documents/{documentId}

Elimina un documento precedentemente caricato.

HTTPcURL

DELETE /v1/darwin/documents/a1b2c3 HTTP/1.1
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 204 No Content

curl -X DELETE "https://api.nic.it/v1/darwin/documents/a1b2c3" \
-H "Authorization: Bearer token..."

Scaricare un documento

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/documents/{documentId}/download

Restituisce il contenuto binario del documento.

HTTPcURL

GET /v1/darwin/documents/a1b2c3/download HTTP/1.1
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="documento-identita.pdf"

...binary content...

curl "https://api.nic.it/v1/darwin/documents/a1b2c3/download" \
-H "Authorization: Bearer token..." \
-o documento-identita.pdf

Eventi Darwin

Cercare gli eventi di una richiesta

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/events?requestId={requestId}

Restituisce l'elenco paginato degli eventi associati a una richiesta. Il parametro type permette di filtrare per tipo di evento.

I principali tipi di evento previsti dall'API sono:

submitted
rejected
toPending
registrarUpdated
registrarUpdateRejected
registrarUpdateApproved
toProcessing
expired
completed
expiredCompleted
updatedRequiredDocuments
cancelled
cancelledCompleted
registryUpdated
registrarUserAssignation
registrarUserRelease
registryUserAssignation
registryUserRelease

HTTPcURL

GET /v1/darwin/events?requestId=125&type=registrarUpdated HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "elements" : [ {
    "requestId" : 125,
    "type" : "registrarUpdated",
    "user" : "darwin.user",
    "message" : "Aggiornamento dati inserito dal Registrar",
    "created" : "2024-04-10T09:30:00+02:00"
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

curl "https://api.nic.it/v1/darwin/events?requestId=125&type=registrarUpdated" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "elements" : [ {
    "requestId" : 125,
    "type" : "registrarUpdated",
    "user" : "darwin.user",
    "message" : "Aggiornamento dati inserito dal Registrar",
    "created" : "2024-04-10T09:30:00+02:00"
  } ],
  "page" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1
  }
}

I risultati della ricerca sono paginati.

Contare gli eventi

1.0 | darwin | admin / domain / darwin |

GET https://api.nic.it/v1/darwin/events/count?requestId={requestId}

Restituisce il numero totale di eventi della richiesta, opzionalmente filtrati per type.

HTTPcURL

GET /v1/darwin/events/count?requestId=125&type=registrarUpdated HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token...

HTTP/1.1 200 OK
Content-Type: application/json

{
  "count" : 1
}

curl "https://api.nic.it/v1/darwin/events/count?requestId=125&type=registrarUpdated" \
-H "Accept: application/json" \
-H "Authorization: Bearer token..."

{
  "count" : 1
}

Errori applicativi più comuni

Oltre ai codici HTTP standard (401 Unauthorized, 403 Forbidden, 404 Not Found), gli endpoint Darwin possono restituire:

400 Bad Request per parametri mancanti, payload non valido o dati incoerenti;
409 Conflict per operazioni non compatibili con lo stato corrente della richiesta o dell'assegnazione;
413 Request Entity Too Large durante il caricamento di documenti troppo grandi.