PUT /v1/switches/
Attiva o disattiva uno switch manuale. L’operazione è idempotente: impostare uno stato già presente restituisce comunque successo.
Attivare o disattivare uno switch modifica in tempo reale il comportamento del centralino sulle chiamate associate.
Parametri URL
| Parametro | Tipo | Descrizione |
|---|
id | int | ID dello switch |
Request Body
Indica lo stato desiderato con uno dei seguenti campi:
| Campo | Tipo | Descrizione |
|---|
active | bool | true per attivare, false per disattivare |
status | int | 1 per attivare, 0 per disattivare |
Se sono presenti entrambi i campi, ha priorità active.
Richiesta
curl -X PUT https://api.mycentralino.com/v1/switches/348 \
-H "X-API-KEY: sk_mycentralino_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"active": true
}'
Risposta Successo
{
"success": true,
"data": {
"id": 348,
"description": "Chiusura Temporanea",
"activation": "*11",
"action": {
"type": "hangup",
"target": null,
"label": "Termina la chiamata"
},
"status": 1,
"active": true
}
}
Errori
400 - Parametro mancante
{
"success": false,
"error": "Parametro mancante: indicare \"active\" (true/false) oppure \"status\" (1/0)"
}
400 - Stato non valido
{
"success": false,
"error": "Stato non valido: usare 1 (attiva) o 0 (disattiva)."
}
404 - Switch non trovato
{
"success": false,
"error": "Switch non trovato"
}
Note
- La risposta contiene lo switch aggiornato con il nuovo
status e active.
- L’endpoint modifica solo lo stato (attivo/disattivo): il codice di attivazione e l’azione si configurano dal pannello di gestione.
