Ühe ostetud numbri andmete lugemine

Loe ühe ostetud numbri kirjet ja selle salvestatud seadistust. See toiming tagastab objekti, mitte lõpp-punkti inventory tagastatava massiivi.

Päring

Kasuta serveripoolseid API autentimisandmeid HTTPS-i kaudu. Näited loevad autentimisandmed keskkonnamuutujatest; need ei sisalda toimivaid autentimisandmeid. Kontrolli välja status.code JSON-vastuse sisus ning ka HTTP olekukoodi. Need pärandsüsteemi päringukäsitlejad ei määra rakenduse vea korral alati HTTP veaolekut.

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

Nõutav teeosa on salvestatud rahvusvaheline telefoninumber, mitte selle UUID ega telefonikeskjaama lühinumber. See päringukäsitleja ei kasuta päringuparameetreid ega päringu sisu.

Vastus

See on vastuse struktuuri näide, mitte kontoandmed ega kehtiv hinnapakkumine.

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

Tagastatavad numbri väljad
Väli	Tähendus
`number, uuid, description, isocode`	Salvestatud telefoninumber, numbri identifikaator, mille sisemist tähendust ei tõlgendata, kirjeldus ja riigikood.
`config`	Salvestatud kõnesihtkohtade, välise suunamise, SMS-i sihtkoha ja SMS-ide suunamise väljad. See lõpp-punkt neid ei muuda.
`features`	Salvestatud kõne-, SMS- ja MMS-teenuse toetamise lipud. Pärandsüsteemis salvestatud lipud ei pruugi olla JSON-i tõeväärtused.
`status.capacity`	Eraldatud ja kasutatud kanalite väärtused, ülevoolu seadistus ning salvestatud ületustasu. Need on salvestatud metaandmed, mitte ajakohane kanalimahu pakkumine ega reaalajas kõnetest.
`status.origination`	Salvestatud kõne päritolu metaandmed. Käsitle identifikaatoreid nende sisemist tähendust tõlgendamata; ära tuleta sisemistest nimedest rakendusloogikat.
`status.service_active, force_codec, force_dtmf`	Salvestatud aktiveerimise ja meedia seadistuse väljad. Üksnes lipp ei tõenda sissetuleva liikluse edukat kohaletoimetamist.
`billing`	Salvestatud CNAM-i, ülevoolu, pikendamise, püsivuse ja loomise väärtused. Nende lugemine ei muuda pikendamise ega muid arvelduse seadistusi.
`price`	Salvestatud liitumis-, kuu- ja minutihinnad ning hinna sees olevate minutite mahud. Päringukäsitleja ei väljasta valuutavälja ega ajakohast hinnapakkumist. Ära tuleta näidisväärtustest valuutat ega kasuta neid kehtiva ostupakkumisena.

Võrreldes lõpp-punktiga inventory, tagastab see lõpp-punkt ka väljad needs_registration, vrating, country_id, area_id, provider_id ja price.perminute_charges. Need on pärandsüsteemi salvestatud väärtused, mitte eraldi vastus isikusamasuse kinnitamise kohta. Viiteidentifikaatoreid tuleb käsitleda nende sisemist tähendust tõlgendamata; ära koosta nende põhjal avastuspäringute URL-e ega tuleta teenusepakkujate vastendusi ilma vastava avastuspäringu vastuseta.

Vastavat numbrit ei leitud

Kui autenditud kontolt ei leita vastavat tühistamata kirjet, on JSON-vastuse sisus välja status.code väärtus 404 ning teade sisaldab teksti number not found. Ära tugine teate lõpus olevale lähtekoodi rea tähisele. Enne uuesti proovimist kontrolli salvestatud numbrit ja lõpp-punkti inventory andmeid.

Tulemuse kasutamine

See toiming loeb salvestatud andmeid. See ei osta numbrit, ei kinnita isikut tõendavaid dokumente, ei muuda sihtkohta ega taga kõne, faksi või sõnumi kohaletoimetamist. Numbri seadistamisel testi iga lubatud teenust eraldi.