PUT /v1/contacts/
Modifica un contatto esistente. Sono aggiornati solo i campi presenti nel body: i campi omessi mantengono il valore corrente.
La modifica dei contatti esistenti è sempre consentita, anche per gli account che hanno raggiunto il limite di 4000 contatti.
Parametri URL
| Parametro | Tipo | Descrizione |
|---|
id | int | ID del contatto da modificare |
Request Body
| Campo | Tipo | Obbligatorio | Descrizione |
|---|
number | string | ❌ | Numero di telefono (max 25 caratteri) |
name | string | ❌ | Nome del contatto (max 80 caratteri) |
company | string | null | ❌ | Azienda (max 50 caratteri) — null o "" per svuotare |
notes | string | null | ❌ | Note (max 255 caratteri) — null o "" per svuotare |
Richiesta
curl -X PUT https://api.mycentralino.com/v1/contacts/12345 \
-H "X-API-KEY: sk_mycentralino_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Mario Bianchi",
"notes": "Aggiornato"
}'
Risposta Successo
{
"success": true,
"data": {
"id": 12345,
"number": "3331234567",
"name": "Mario Bianchi",
"company": "ACME S.r.l.",
"notes": "Aggiornato"
}
}
Errori
400 - Dati non validi
{
"success": false,
"error": "Il campo \"name\" supera i 80 caratteri."
}
404 - Contatto non trovato
{
"success": false,
"error": "Contatto non trovato"
}
409 - Numero già presente
{
"success": false,
"error": "Esiste gia' un contatto con questo numero in rubrica."
}
Note
- I campi non inclusi nel body non vengono modificati (aggiornamento parziale).
- Per svuotare
company o notes, invia il campo con valore null o stringa vuota.
