Skip to main content

​
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

ParametroTipoDescrizione
idintID del contatto da modificare

​
Request Body

CampoTipoObbligatorioDescrizione
numberstring❌Numero di telefono (max 25 caratteri)
namestring❌Nome del contatto (max 80 caratteri)
companystring | null❌Azienda (max 50 caratteri) — null o "" per svuotare
notesstring | 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"
  }'

<?php
$id = 12345;
$data = [
    'name' => 'Mario Bianchi',
    'notes' => 'Aggiornato'
];

$ch = curl_init("https://api.mycentralino.com/v1/contacts/{$id}");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_POSTFIELDS => json_encode($data),
    CURLOPT_HTTPHEADER => [
        'X-API-KEY: sk_mycentralino_your_api_key',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));

import requests

headers = {
    'X-API-KEY': 'sk_mycentralino_your_api_key',
    'Content-Type': 'application/json'
}
contact_id = 12345
data = {
    'name': 'Mario Bianchi',
    'notes': 'Aggiornato'
}

response = requests.put(
    f'https://api.mycentralino.com/v1/contacts/{contact_id}',
    headers=headers,
    json=data
)
print(response.json())

​
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.