Skip to main content

GET /v1/voip/status

Restituisce lo stato di registrazione di tutte le numerazioni VoIP associate al centralino.

Richiesta

curl -X GET https://api.mycentralino.com/v1/voip/status \
  -H "X-API-KEY: sk_mycentralino_your_api_key"

Risposta

{
  "success": true,
  "data": [
    {
      "number": "0686858483",
      "registered": true,
      "provider": "Convergenze",
      "provider_label": "MyCentralino CVG",
      "username": "user123456",
      "sip_server": "sip.provider.it",
      "description": "Numero principale",
      "note": ""
    },
    {
      "number": "0212345678",
      "registered": false,
      "provider": "Messagenet",
      "provider_label": "MyCentralino MSG",
      "username": "user789012",
      "sip_server": "sip.messagenet.it",
      "description": "Numero secondario",
      "note": "Da verificare"
    }
  ],
  "count": 2,
  "summary": {
    "total": 2,
    "registered": 1,
    "unregistered": 1
  }
}

Campi Risposta

CampoTipoDescrizione
numberstringNumero telefonico
registeredboolStato registrazione SIP
providerstringProvider VoIP tecnico
provider_labelstringNome provider leggibile
usernamestringUsername SIP
sip_serverstringServer SIP del provider
descriptionstringDescrizione del numero
notestringNote aggiuntive

Provider Labels

ProviderLabel
ConvergenzeMyCentralino CVG
MessagenetMyCentralino MSG
SBCMyCentralino
VIRTUALVirtuale

Note

  • I numeri con provider VIRTUAL o SBC risultano sempre registrati
  • Lo stato registered: false indica un problema di connettività con il provider VoIP
  • Usa il summary per un monitoraggio rapido dello stato generale