Načtení jednoho zakoupeného čísla

Načtěte jeden záznam zakoupeného čísla a jeho uloženou konfiguraci. Tato operace vrací objekt namísto pole, které vrací koncový bod inventory.

Požadavek

Používejte přihlašovací údaje k API na straně serveru a komunikujte přes HTTPS. Příklady načítají přihlašovací údaje z proměnných prostředí; neobsahují žádné funkční přihlašovací údaje. Zkontrolujte status.code v těle JSON i stav HTTP. Tyto starší obslužné rutiny nenastavují při chybě aplikace vždy chybový stav HTTP.

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

Povinným segmentem cesty je uložené telefonní číslo v mezinárodním formátu, nikoli jeho UUID nebo pobočka telefonní ústředny. Tato obslužná rutina nepoužívá žádné parametry dotazu ani tělo požadavku.

Odpověď

Toto je ukázka struktury odpovědi, nikoli údaje účtu nebo aktuální cenová nabídka.

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

Vrácená pole čísla
Pole	Význam
`number, uuid, description, isocode`	Uložené telefonní číslo, identifikátor čísla bez interpretovatelného vnitřního významu, popis a kód země.
`config`	Uložená pole cílů hlasových hovorů, externího přesměrování, cíle SMS a přesměrování SMS. Tento koncový bod je neupravuje.
`features`	Uložené příznaky podpory hlasových hovorů, SMS a MMS. U starších uložených příznaků není zaručeno, že jde o booleovské hodnoty JSON.
`status.capacity`	Hodnoty přidělených a využitých kanálů, nastavení přetečení a uložený poplatek za překročení limitu. Jde o uložená metadata, nikoli o aktuální nabídku kapacity nebo test skutečného hovoru.
`status.origination`	Uložená metadata původu hovorů. Zacházejte s identifikátory jako s hodnotami bez interpretovatelného vnitřního významu; neodvozujte logiku aplikace z interních názvů.
`status.service_active, force_codec, force_dtmf`	Uložená pole aktivace a konfigurace médií. Samotný příznak nedokazuje úspěšné doručení příchozí komunikace.
`billing`	Uložené hodnoty CNAM, přetečení, obnovování, trvalosti a vytvoření. Jejich načtení nemění obnovování ani jiná nastavení účtování.
`price`	Uložené zřizovací, měsíční a minutové ceny a příděly minut. Obslužná rutina neposkytuje pole měny ani aktuální cenovou nabídku. Z ukázkových hodnot neodvozujte měnu ani je nepoužívejte jako aktuální cenovou nabídku pro nákup.

Ve srovnání s koncovým bodem inventory vrací tento koncový bod také needs_registration, vrating, country_id, area_id, provider_id a price.perminute_charges. Jde o starší uložené hodnoty, nikoli o samostatnou odpověď o schválení totožnosti. S referenčními identifikátory zacházejte jako s hodnotami bez interpretovatelného vnitřního významu; bez příslušné odpovědi pro zjišťování dostupných prostředků z nich nesestavujte adresy URL pro toto zjišťování ani neodvozujte přiřazení poskytovatelů.

Žádné odpovídající číslo

Pokud pro ověřený účet není nalezen žádný odpovídající záznam, který nebyl zneplatněn, tělo JSON obsahuje status.code 404 a zprávu obsahující number not found. Nespoléhejte na příponu zprávy s údajem o řádku zdrojového kódu. Před dalším pokusem zkontrolujte uložené číslo a inventory.

Použití výsledku

Jde o načtení uložených dat. Tato operace nezakupuje číslo, neschvaluje doklady totožnosti, nemění cíl ani nezaručuje doručení hovoru, faxu či zprávy. Při konfiguraci čísla otestujte každou povolenou službu zvlášť.