GET /v1/contacts
Restituisce i contatti della rubrica del tuo centralino. Supporta ricerca e paginazione.
La rubrica è la stessa usata dal centralino per il riconoscimento del chiamante: i contatti gestiti via API vengono mostrati automaticamente durante le chiamate.
Parametri Query
| Parametro | Tipo | Default | Descrizione |
|---|
page | int | 1 | Pagina da visualizzare |
limit | int | 200 | Contatti per pagina (max 500) |
search | string | — | Filtra per numero, nome o azienda |
Richiesta
curl -X GET "https://api.mycentralino.com/v1/contacts?page=1&limit=200&search=rossi" \
-H "X-API-KEY: sk_mycentralino_your_api_key"
Risposta
{
"success": true,
"data": [
{
"id": 12345,
"number": "3331234567",
"name": "Mario Rossi",
"company": "ACME S.r.l.",
"notes": "Cliente principale"
},
{
"id": 12346,
"number": "0686858483",
"name": "Anna Bianchi",
"company": null,
"notes": null
}
],
"pagination": {
"current_page": 1,
"total_pages": 1,
"total_contacts": 2,
"per_page": 200,
"showing_from": 1,
"showing_to": 2
},
"limit": {
"max": 4000,
"used": 2,
"remaining": 3998
},
"filters": {
"search": "rossi"
}
}
Campi Risposta
| Campo | Tipo | Descrizione |
|---|
id | int | ID univoco del contatto |
number | string | Numero di telefono |
name | string | Nome del contatto |
company | string | null | Azienda (opzionale) |
notes | string | null | Note (opzionale) |
| Campo | Tipo | Descrizione |
|---|
current_page | int | Pagina corrente |
total_pages | int | Numero totale di pagine |
total_contacts | int | Contatti totali (filtrati da search) |
per_page | int | Contatti per pagina |
showing_from | int | Indice del primo contatto mostrato |
showing_to | int | Indice dell’ultimo contatto mostrato |
Oggetto limit
| Campo | Tipo | Descrizione |
|---|
max | int | Limite massimo di contatti per account (4000) |
used | int | Contatti attualmente registrati |
remaining | int | Contatti ancora inseribili |
Note
- La ricerca con
search filtra simultaneamente su numero, nome e azienda.
- Il limite massimo è di 4000 contatti per account: vedi Aggiungi Contatto.
