Bulk Transfer
I seguenti metodi permettono di gestire le richieste di bulk transfer dei domini. Per tutti i metodi è richiesta la presenza dello scope domain:bulk nel token.
Warning
I metodi relativi alla bulk-transfer non sono al momento disponibile nella piattaforma di test (pubtest).
Stati delle richieste di bulk transfer
Gli stati possibili di una richiesta di bulk transfer sono:
| Stato | Descrizione |
|---|---|
SUBMITTED |
Richiesta inserita |
DOC_WAITING |
In attesa della documentazione |
DOC_OK |
Documentazione verificata |
VERIFIED |
Richiesta verificata |
APPROVED |
Richiesta approvata |
REJECTED |
Richiesta respinta |
CANCELLED |
Richiesta annullata |
EXPIRING |
Richiesta in scadenza |
EXPIRED |
Richiesta scaduta |
COMPLETED |
Richiesta completata |
Stati dei domini in bulk transfer
Gli stati possibili dei domini inclusi in una richiesta di bulk transfer sono:
| Stato | Descrizione |
|---|---|
SUBMITTED |
Dominio inserito nella richiesta |
VERIFIED |
Dominio verificato |
APPROVED |
Dominio approvato |
REJECTED |
Dominio respinto |
EXPIRED |
Dominio scaduto |
FAILED |
Trasferimento del dominio fallito |
TRANSFERRED |
Dominio trasferito |
Ricercare le richieste di bulk transfer
GET https://api.nic.it/v1/domains/bulkTransfers
Permette di ottenere l'elenco paginato delle richieste di bulk transfer del Registrar, esempio:
GET /v1/domains/bulkTransfers HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token....
HTTP/1.1 200 OK
Content-Type: application/json
{
"elements": [
{
"id": 12345,
"source": {
"applicant": "Mario Rossi",
"applicantCF": "RSSMRA80A01G702K",
"admin": "admin@source-registrar.it",
"registrar": "SRC-REG"
},
"destination": {
"registrar": "DST-REG"
},
"status": "SUBMITTED",
"created": "2024-05-10T09:30:00+02:00",
"lastupdate": "2024-05-10T09:30:00+02:00"
}
],
"page": {
"number": 0,
"size": 20
}
}
I risultati della ricerca sono paginati.
Creare una richiesta di bulk transfer
POST https://api.nic.it/v1/domains/bulkTransfers
Permette di creare una nuova richiesta di bulk transfer. Il corpo della richiesta deve contenere:
| Campo | Obbligatorio | Descrizione |
|---|---|---|
source.applicant |
Sì | Nominativo del richiedente per il Registrar sorgente |
source.applicantCF |
Sì | Codice fiscale del richiedente per il Registrar sorgente |
source.admin |
No | Riferimento amministrativo del Registrar sorgente |
destination.registrar |
Sì | Tag del Registrar di destinazione |
domains |
Sì | Elenco dei domini da trasferire |
Esempio:
POST /v1/domains/bulkTransfers HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: api.nic.it
Authorization: Bearer token....
{
"source": {
"applicant": "Mario Rossi",
"applicantCF": "RSSMRA80A01G702K",
"admin": "admin@source-registrar.it"
},
"destination": {
"registrar": "DST-REG"
},
"domains": [
"bulk-transfer-test-1.it",
"bulk-transfer-test-2.it"
]
}
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": 12345,
"source": {
"applicant": "Mario Rossi",
"applicantCF": "RSSMRA80A01G702K",
"admin": "admin@source-registrar.it",
"registrar": "SRC-REG"
},
"destination": {
"registrar": "DST-REG"
},
"status": "SUBMITTED",
"created": "2024-05-10T09:30:00+02:00",
"lastupdate": "2024-05-10T09:30:00+02:00"
}
curl "https://api.nic.it/v1/domains/bulkTransfers" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer token..." \
-d '{
"source": {
"applicant": "Mario Rossi",
"applicantCF": "RSSMRA80A01G702K",
"admin": "admin@source-registrar.it"
},
"destination": {
"registrar": "DST-REG"
},
"domains": [
"bulk-transfer-test-1.it",
"bulk-transfer-test-2.it"
]
}'
http POST https://api.nic.it/v1/domains/bulkTransfers \
"Authorization: Bearer token..." \
source:='{"applicant":"Mario Rossi","applicantCF":"RSSMRA80A01G702K","admin":"admin@source-registrar.it"}' \
destination:='{"registrar":"DST-REG"}' \
domains:='["bulk-transfer-test-1.it","bulk-transfer-test-2.it"]'
Ottenere una richiesta di bulk transfer
GET https://api.nic.it/v1/domains/bulkTransfers/{bulkTransferId}
Permette di ottenere i dati di una richiesta di bulk transfer tramite l'id numerico assegnato dal Registro, esempio:
GET /v1/domains/bulkTransfers/12345 HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token....
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": 12345,
"source": {
"applicant": "Mario Rossi",
"applicantCF": "RSSMRA80A01G702K",
"admin": "admin@source-registrar.it",
"registrar": "SRC-REG"
},
"destination": {
"registrar": "DST-REG"
},
"status": "APPROVED",
"approvalDate": "2024-05-11T10:15:00+02:00",
"created": "2024-05-10T09:30:00+02:00",
"lastupdate": "2024-05-11T10:15:00+02:00"
}
Ottenere i domini di una richiesta di bulk transfer
GET https://api.nic.it/v1/domains/bulkTransfers/{bulkTransferId}/domains
Permette di ottenere l'elenco paginato dei domini inclusi in una richiesta di bulk transfer, esempio:
I risultati sono paginati.
Ottenere gli eventi di una richiesta di bulk transfer
GET https://api.nic.it/v1/domains/bulkTransfers/{bulkTransferId}/events
Permette di ottenere l'elenco paginato degli eventi associati a una richiesta di bulk transfer, esempio:
GET /v1/domains/bulkTransfers/12345/events HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token....
HTTP/1.1 200 OK
Content-Type: application/json
{
"elements": [
{
"type": "submitted",
"description": "Bulk transfer request submitted",
"created": "2024-05-10T09:30:00+02:00"
},
{
"type": "approved",
"description": "Bulk transfer request approved",
"created": "2024-05-11T10:15:00+02:00"
}
],
"page": {
"number": 0,
"size": 20
}
}
I risultati sono paginati.
Approvare una richiesta di bulk transfer
PUT https://api.nic.it/v1/domains/bulkTransfers/{bulkTransferId}/approve
Permette di approvare una richiesta di bulk transfer. Operazione possibile solo per il registrar di destinazione e solo quando la richiesta di bulk-transfer è nello stato VERFIED. Il corpo della richiesta deve contenere i dati del richiedente:
| Campo | Obbligatorio | Descrizione |
|---|---|---|
applicant |
Sì | Nominativo del richiedente |
applicantCF |
Sì | Codice fiscale del richiedente |
admin |
No | Rappresentante legale (facoltativo se coincide con il richiedente) |
Esempio:
Annullare una richiesta di bulk transfer
PUT https://api.nic.it/v1/domains/bulkTransfers/{bulkTransferId}/cancel
Permette di annullare una richiesta di bulk transfer. L'operazione è possibile solo quando è nello stato VERIFIED. Esempio:
PUT /v1/domains/bulkTransfers/12345/cancel HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token....
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": 12345,
"source": {
"applicant": "Mario Rossi",
"applicantCF": "RSSMRA80A01G702K",
"admin": "admin@source-registrar.it",
"registrar": "SRC-REG"
},
"destination": {
"registrar": "DST-REG"
},
"status": "CANCELLED",
"created": "2024-05-10T09:30:00+02:00",
"lastupdate": "2024-05-10T11:45:00+02:00"
}
Ottenere i dati per il documento PDF di bulk transfer
GET https://api.nic.it/v1/domains/bulkTransfers/{bulkTransferId}/pdf-data
Permette di ottenere i dati da utilizzare per la generazione del documento PDF relativo alla richiesta di bulk transfer, esempio:
GET /v1/domains/bulkTransfers/12345/pdf-data HTTP/1.1
Accept: application/json
Host: api.nic.it
Authorization: Bearer token....
HTTP/1.1 200 OK
Content-Type: application/json
{
"source": {
"applicant": "Mario Rossi",
"applicantCF": "RSSMRA80A01G702K",
"admin": "admin@source-registrar.it",
"registrar": "SRC-REG",
"org": "Source Registrar Srl",
"regcode": "12345678901"
},
"destination": {
"applicant": "Mario Rossi",
"applicantCF": "RSSMRA80A01G702K",
"admin": "admin@destination-registrar.it",
"registrar": "DST-REG",
"org": "Destination Registrar Srl",
"regcode": "10987654321"
}
}