Registrazione Mittente SMS
Invia una richiesta di registrazione per un mittente alfanumerico in uno o più paesi.
POST
/api/v1/{account_code}/sms/senders/registration-requests/
Authorization
Bearer {token} — 56 caratteri
Permette di sottomettere una richiesta di registrazione per un mittente SMS.
La risposta contiene un record per ogni paese specificato in country_codes,
ciascuno con il proprio stato di approvazione.
Approvazione manuale
Le richieste di registrazione mittente sono soggette a revisione manuale.
Il campo
translated_status indicherà lo stato corrente
(Submitted, Approved, Rejected).
Parametri (JSON)
| Parametro | Richiesto | Tipo | Descrizione / Esempio |
|---|---|---|---|
| account_code | SI | string (UUID) | Codice account XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX — passato nel path URL |
| country_codes | SI | array<string> | Codici paese ISO (es: ["IT", "ES"]) |
| sender | SI | string (max 11) / numeric (max 16) | Nome mittente da registrare (es: "MioSender") |
| data | SI | object | Dati aziendali del richiedente — vedi dettagli sotto |
Oggetto data
| Campo | Richiesto | Tipo | Descrizione |
|---|---|---|---|
| name | SI | string | Ragione sociale (es: "Company SpA") |
| vat | SI | string | Partita IVA valida |
| address | SI | string | Indirizzo completo (via, CAP, città, provincia, nazione) |
| SI | string | Email di contatto valida | |
| pec | NO | string | Indirizzo PEC (posta elettronica certificata) |
| phone | SI | string | Numero di telefono con prefisso (es: "+393xxxxxxxxx") |
Esempio Richiesta
JSON
{
"country_codes": ["IT", "ES"],
"sender": "MioSender",
"data": {
"name": "Company SpA",
"vat": "IT12345678901",
"address": "Via Esempio 1, 00042, Roma, RM, Italia",
"email": "info@esempio.it",
"pec": "info@pec.esempio.it",
"phone": "+390612345678"
}
}Risposta Successo
200 OK
Un array con un oggetto per ogni paese richiesto in country_codes.
JSON
[
{
"status": 0,
"translated_status": "Submitted",
"sender": "MioSender",
"country_code": "IT",
"data": {
"name": "Company SpA",
"vat": "IT12345678901",
"address": "Via Esempio 1, 00042, Roma, RM, Italia",
"email": "info@esempio.it",
"pec": "info@pec.esempio.it",
"phone": "+390612345678"
},
"rejection_reason": null,
"created": "2025-01-07T17:29:50.500720+01:00",
"modified": "2025-01-07T17:29:50.500720+01:00"
},
{
"status": 0,
"translated_status": "Submitted",
"sender": "MioSender",
"country_code": "ES",
"data": {
"name": "Company SpA",
"vat": "IT12345678901",
"address": "Via Esempio 1, 00042, Roma, RM, Italia",
"email": "info@esempio.it",
"pec": "info@pec.esempio.it",
"phone": "+390612345678"
},
"rejection_reason": null,
"created": "2025-01-07T17:29:50.500720+01:00",
"modified": "2025-01-07T17:29:50.500720+01:00"
}
]Campi Risposta
| Campo | Tipo | Descrizione |
|---|---|---|
| status | integer | Codice stato numerico della richiesta |
| translated_status | string | Stato leggibile: Submitted, Approved, Rejected |
| sender | string | Nome mittente richiesto |
| country_code | string | Codice paese ISO per questa voce |
| data | object | Dati aziendali inviati |
| rejection_reason | string|null | Motivo rifiuto (presente solo se Rejected) |
| created | string | Timestamp creazione (ISO 8601) |
| modified | string | Timestamp ultima modifica (ISO 8601) |