Egy megvásárolt telefonszám adatainak lekérése

Egy megvásárolt telefonszám rekordjának és tárolt konfigurációjának lekérése. Ez a művelet objektumot ad vissza, míg az inventory végpont tömböt.

Kérés

Használjon szerveroldali API-hitelesítő adatokat HTTPS-kapcsolaton keresztül. A példák környezeti változókból olvassák be a hitelesítő adatokat; működő hitelesítő adatokat nem tartalmaznak. Ellenőrizze a status.code értékét a JSON-törzsben, valamint a HTTP-állapotot is. Ezek az örökölt kezelők alkalmazáshiba esetén nem állítanak be következetesen hibát jelző HTTP-állapotot.

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

A kötelező útvonalszegmens a tárolt nemzetközi telefonszám, nem pedig annak UUID azonosítója vagy egy PBX-mellék. Ez a kezelő nem használ lekérdezési paramétereket vagy kéréstörzset.

Válasz

Ez a válasz felépítését szemléltető példa, nem fiókadat vagy aktuális árajánlat.

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

A telefonszám visszaadott mezői
Mező	Jelentés
`number, uuid, description, isocode`	A tárolt telefonszám, a telefonszám belső jelentéssel nem értelmezendő azonosítója, leírása és országkódja.
`config`	A hanghívások céljainak, a külső átirányításnak, az SMS-célnak és az SMS-továbbításnak a tárolt mezői. Ez a végpont nem módosítja őket.
`features`	A hanghívási, SMS- és MMS-képességek tárolt jelzői. Az örökölt tárolt jelzőkről nem garantálható, hogy JSON logikai értékek.
`status.capacity`	A hozzárendelt és használt csatornák értékei, a túlcsordulás beállítása és a tárolt túllépési díj. Ezek tárolt metaadatok, nem friss kapacitásajánlat vagy élő hívásteszt eredményei.
`status.origination`	A hívásindítás tárolt metaadatai. Az azonosítókat belső jelentésük értelmezése nélkül kezelje; a belső nevekből ne vezessen le alkalmazáslogikát.
`status.service_active, force_codec, force_dtmf`	Az aktiválás és a médiakonfiguráció tárolt mezői. Egy jelző önmagában nem bizonyítja a bejövő forgalom sikeres kézbesítését.
`billing`	A CNAM, a túlcsordulás, a megújítás, a tartós megőrzés és a létrehozás tárolt értékei. Lekérésük nem módosítja a megújítási vagy más számlázási beállításokat.
`price`	Tárolt beállítási díjak, havidíjak, percdíjak és perckeretek. A kezelő nem ad vissza pénznemmezőt vagy friss árajánlatot. A példaértékekből ne következtessen a pénznemre, és ne használja őket aktuális vásárlási árajánlatként.

Az inventory végponthoz képest ez a végpont a következő mezőket is visszaadja: needs_registration, vrating, country_id, area_id, provider_id és price.perminute_charges. Ezek örökölt tárolt értékek, nem a személyazonosság jóváhagyásáról szóló külön válasz. A hivatkozási azonosítókat belső jelentésük értelmezése nélkül kell kezelni; a megfelelő felderítési válasz nélkül ne állítson össze belőlük felderítési URL-eket, és ne következtessen belőlük szolgáltatói megfeleltetésekre.

Nincs megfelelő telefonszám

Ha a hitelesített fiókhoz nem található megfelelő, nem érvénytelenített rekord, a JSON-törzsben a status.code 404 értékű, és az üzenet tartalmazza a number not found szöveget. Ne támaszkodjon az üzenet forráskódsorra utaló utótagjára. Újrapróbálkozás előtt ellenőrizze a tárolt telefonszámot és az inventory végpont eredményét.

Az eredmény felhasználása

Ez a művelet mentett adatokat kér le. Nem vásárol telefonszámot, nem hagy jóvá személyazonosító okmányokat, nem módosít célt, és nem garantálja a hívások, faxok vagy üzenetek kézbesítését. A telefonszám konfigurálásakor minden engedélyezett szolgáltatást külön teszteljen.