Lexoni një numër të blerë

Lexoni një regjistrim të një numri të blerë dhe konfigurimin e tij të ruajtur. Ky veprim kthen një objekt në vend të vargut që kthen pika fundore inventory.

Kërkesa

Përdorni kredencialet e API-së në anën e serverit përmes HTTPS. Shembujt i lexojnë kredencialet nga ndryshoret e mjedisit; ata nuk përmbajnë kredenciale funksionale. Kontrolloni status.code në trupin JSON, si dhe statusin HTTP. Këta përpunues të sistemit të vjetër nuk vendosin gjithmonë një status gabimi HTTP për një gabim të aplikacionit.

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

Segmenti i detyrueshëm i shtegut është numri ndërkombëtar i telefonit i ruajtur, jo UUID i tij apo një numër i brendshëm PBX. Ky përpunues nuk përdor parametra të pyetjes apo trup kërkese.

Përgjigjja

Kjo është një strukturë ilustruese e përgjigjes, jo të dhëna të llogarisë apo një ofertë aktuale çmimi.

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

Fushat e numrit që kthehen
Fusha	Kuptimi
`number, uuid, description, isocode`	Numri i telefonit i ruajtur, identifikuesi i numrit që duhet trajtuar pa interpretuar strukturën e tij, përshkrimi dhe kodi i shtetit.
`config`	Fushat e ruajtura të destinacioneve të thirrjeve zanore, të përcjelljes së jashtme, të destinacionit të SMS-ve dhe të përcjelljes së SMS-ve. Kjo pikë fundore nuk i ndryshon ato.
`features`	Treguesit e ruajtur të aftësive për thirrje zanore, SMS dhe MMS. Nuk garantohet që treguesit e ruajtur nga sistemi i vjetër të jenë vlera booleane JSON.
`status.capacity`	Vlerat e kanaleve të caktuara dhe të përdorura, cilësimi për tejkalimin e kapacitetit dhe tarifa e ruajtur për tejkalimin. Këto janë të dhëna përshkruese të ruajtura, jo një ofertë e re kapaciteti apo një provë thirrjeje në kohë reale.
`status.origination`	Të dhënat përshkruese të ruajtura për origjinimin. Trajtojini identifikuesit pa interpretuar strukturën e tyre; mos nxirrni logjikën e aplikacionit nga emrat e brendshëm.
`status.service_active, force_codec, force_dtmf`	Fushat e ruajtura të aktivizimit dhe të konfigurimit të medias. Një tregues i vetëm nuk provon se trafiku hyrës është dorëzuar me sukses.
`billing`	Vlerat e ruajtura për CNAM, tejkalimin e kapacitetit, rinovimin, ruajtjen e përhershme dhe krijimin. Leximi i tyre nuk ndryshon rinovimin apo cilësime të tjera të faturimit.
`price`	Çmimet e ruajtura të aktivizimit, mujore dhe për minutë, si dhe sasitë e minutave të përfshira. Përpunuesi nuk jep fushë monedhe apo ofertë të re çmimi. Mos e përcaktoni monedhën nga vlerat e shembullit dhe mos i përdorni ato si ofertë aktuale çmimi për blerje.

Krahasuar me inventory, kjo pikë fundore kthen gjithashtu needs_registration, vrating, country_id, area_id, provider_id dhe price.perminute_charges. Këto janë vlera të ruajtura nga sistemi i vjetër, jo një përgjigje më vete për miratimin e identitetit. Identifikuesit e referencës duhen trajtuar pa interpretuar strukturën e tyre; mos ndërtoni URL zbulimi dhe mos nxirrni lidhje me ofruesit prej tyre pa përgjigjen përkatëse të zbulimit.

Nuk ka numër që përputhet

Nëse për llogarinë e autentikuar nuk gjendet asnjë regjistrim që përputhet dhe që nuk është anuluar, trupi JSON ka status.code 404 dhe një mesazh që përmban number not found. Mos u mbështetni te prapashtesa e tij që tregon rreshtin e kodit burimor. Kontrolloni numrin e ruajtur dhe inventory përpara se të provoni përsëri.

Përdorni rezultatin

Ky është një lexim i të dhënave të ruajtura. Ai nuk blen numër, nuk miraton dokumente identiteti, nuk ndryshon destinacion dhe nuk garanton se një thirrje, faks apo mesazh do të dorëzohet. Provoni veçmas çdo shërbim të aktivizuar kur konfiguroni një numër.