Citirea unui număr achiziționat

Citiți o înregistrare pentru un număr achiziționat și configurația sa stocată. Această operațiune returnează un obiect, în locul tabloului returnat de endpointul inventory.

Cerere

Utilizați credențiale API pe partea de server, prin HTTPS. Exemplele citesc credențialele din variabile de mediu; ele nu conțin credențiale funcționale. Verificați status.code în corpul JSON, precum și codul de stare HTTP. Aceste rutine de procesare moștenite nu setează în mod consecvent un cod de stare HTTP de eroare atunci când apare o eroare a aplicației.

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

Segmentul obligatoriu al căii este numărul de telefon internațional stocat, nu identificatorul său UUID sau o extensie PBX. Această rutină de procesare nu utilizează parametri de interogare sau un corp al cererii.

Răspuns

Aceasta este o structură de răspuns cu rol ilustrativ, nu date ale contului sau o ofertă de preț actuală.

{
  "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"
  }
}

Câmpurile returnate pentru număr
Câmp	Semnificație
`number, uuid, description, isocode`	Numărul de telefon stocat, identificatorul opac al numărului, descrierea și codul țării.
`config`	Câmpurile stocate pentru destinațiile de voce, redirecționarea externă, destinația SMS și redirecționarea SMS. Acest endpoint nu le modifică.
`features`	Indicatorii stocați ai capabilităților de voce, SMS și MMS. Nu există garanția că indicatorii stocați moșteniți sunt valori booleene JSON.
`status.capacity`	Valorile pentru canalele alocate și utilizate, setarea pentru depășirea capacității și tariful stocat pentru depășire. Acestea sunt metadate stocate, nu o ofertă actualizată privind capacitatea sau un test de apel în timp real.
`status.origination`	Metadatele stocate privind originarea. Tratați identificatorii ca fiind opaci; nu deduceți logica aplicației din denumirile interne.
`status.service_active, force_codec, force_dtmf`	Câmpurile stocate pentru activare și configurarea media. Un indicator singur nu dovedește livrarea cu succes a traficului de intrare.
`billing`	Valorile stocate pentru CNAM, depășirea capacității, reînnoire, persistență și creare. Citirea lor nu modifică reînnoirea sau alte setări de facturare.
`price`	Prețurile stocate pentru activare, abonamentul lunar și utilizarea pe minut, precum și alocările de minute. Rutina de procesare nu furnizează un câmp pentru monedă sau o ofertă actualizată. Nu deduceți moneda din valorile de exemplu și nu le utilizați ca ofertă actuală de achiziție.

În comparație cu inventory, acest endpoint returnează și needs_registration, vrating, country_id, area_id, provider_id și price.perminute_charges. Acestea sunt valori stocate moștenite, nu un răspuns separat privind aprobarea identității. Identificatorii de referință trebuie tratați ca fiind opaci; nu construiți URL-uri de descoperire și nu deduceți din ei corespondențe cu furnizorii fără răspunsul de descoperire corespunzător.

Niciun număr corespunzător

Dacă pentru contul autentificat nu se găsește nicio înregistrare corespunzătoare care să nu fie anulată, corpul JSON conține status.code 404 și un mesaj care conține number not found. Nu vă bazați pe sufixul mesajului care indică linia din codul sursă. Verificați numărul stocat și inventory înainte de a încerca din nou.

Utilizarea rezultatului

Această operațiune citește date salvate. Nu achiziționează un număr, nu aprobă documente de identitate, nu modifică o destinație și nu garantează că un apel, un fax sau un mesaj va fi livrat. Testați separat fiecare serviciu activat atunci când configurați un număr.