Leggere un numero acquistato

Leggere il record di un numero acquistato e la relativa configurazione memorizzata. Questa operazione restituisce un oggetto anziché l’array dell’endpoint inventory.

Richiesta

Utilizzare credenziali API lato server tramite HTTPS. Gli esempi leggono le credenziali dalle variabili d’ambiente; non contengono credenziali funzionanti. Controllare status.code nel corpo JSON oltre allo stato HTTP. Questi gestori legacy non impostano sistematicamente uno stato di errore HTTP in presenza di un errore applicativo.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/numberinfo/12025550100"

Il segmento obbligatorio del percorso è il numero telefonico internazionale memorizzato, non il suo UUID né un interno del centralino PBX. Questo gestore non utilizza parametri di query né un corpo della richiesta.

Risposta

Questa struttura di risposta è a scopo illustrativo: non contiene dati dell’account né costituisce un preventivo aggiornato.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550100",
    "uuid": "NUMBER_UUID",
    "description": "Main reception",
    "isocode": "US",
    "config": {
      "uri": "sip:reception@example.com",
      "uri2": "",
      "uri3": "",
      "forward_destination": "",
      "sms_uri": "",
      "sms_forward_destination": ""
    },
    "features": {
      "voice": "1",
      "sms": "1",
      "mms": "0"
    },
    "status": {
      "capacity": {
        "assigned_channels": "2",
        "used_channels": "0",
        "overflow": "0",
        "overage_charge": "0.01"
      },
      "origination": {
        "origination_trunk_id": "ORIGINATION_ID",
        "origination_trunk_name": "ORIGINATION_NAME",
        "origination_country_iso": "US",
        "origination_continent_iso": "NA",
        "origination_continent_name": "North America"
      },
      "service_active": "1",
      "force_codec": "",
      "force_dtmf": ""
    },
    "billing": {
      "cnam": "0",
      "overflow": "0",
      "autorenew": "1",
      "persistent": "0",
      "date_created": "2026-01-01 00:00:00"
    },
    "price": {
      "setup_price": "0.00",
      "monthly_price": "1.00",
      "per_minute": "0.01",
      "free_minutes": "0",
      "remaining_minutes": "0",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

Campi del numero restituiti
Campo	Significato
`number, uuid, description, isocode`	Il numero telefonico memorizzato, l’identificativo opaco del numero, la descrizione e il codice del paese.
`config`	Campi memorizzati relativi alle destinazioni vocali, all’inoltro esterno, alla destinazione SMS e all’inoltro degli SMS. Questo endpoint non li modifica.
`features`	Indicatori memorizzati delle funzionalità voce, SMS e MMS. Non è garantito che gli indicatori legacy memorizzati siano valori booleani JSON.
`status.capacity`	Valori dei canali assegnati e utilizzati, impostazione di trabocco e addebito per l’utilizzo eccedente memorizzato. Si tratta di metadati memorizzati, non di un preventivo aggiornato sulla capacità né di una prova di chiamata in tempo reale.
`status.origination`	Metadati di originazione memorizzati. Trattare gli identificativi come opachi; non ricavare la logica applicativa dai nomi interni.
`status.service_active, force_codec, force_dtmf`	Campi memorizzati di attivazione e configurazione dei flussi multimediali. Un indicatore da solo non dimostra che la consegna in ingresso sia riuscita.
`billing`	Valori memorizzati relativi a CNAM, trabocco, rinnovo, persistenza e creazione. La loro lettura non modifica il rinnovo né altre impostazioni di fatturazione.
`price`	Prezzi memorizzati di attivazione, mensili e al minuto, e quantità di minuti inclusi. Il gestore non fornisce alcun campo relativo alla valuta né un preventivo aggiornato. Non dedurre la valuta dai valori di esempio e non utilizzarli come preventivo di acquisto attuale.

Rispetto a inventory, questo endpoint restituisce anche needs_registration, vrating, country_id, area_id, provider_id e price.perminute_charges. Si tratta di valori legacy memorizzati, non di una risposta separata di approvazione dell’identità. Gli ID di riferimento devono essere trattati come opachi; non costruire URL di individuazione né dedurre da essi associazioni con i fornitori senza la risposta di individuazione appropriata.

Nessun numero corrispondente

Se per l’account autenticato non viene trovato alcun record corrispondente non annullato, il corpo JSON contiene status.code 404 e un messaggio contenente number not found. Non fare affidamento sul suffisso che indica la riga del codice sorgente. Controllare il numero memorizzato e inventory prima di riprovare.

Utilizzare il risultato

Questa operazione legge dati salvati. Non acquista un numero, non approva documenti d’identità, non modifica una destinazione e non garantisce che una chiamata, un fax o un messaggio vengano recapitati. Durante la configurazione di un numero, verificare separatamente ogni servizio abilitato.