Lees een aangekoopte nommer

Lees een rekord van 'n aangekoopte nommer en die gestoorde konfigurasie daarvan. Hierdie bewerking gee 'n objek terug eerder as die inventory-eindpunt se skikking.

Versoek

Gebruik API-aanmeldbesonderhede aan die bedienerkant oor HTTPS. Die voorbeelde lees aanmeldbesonderhede uit omgewingsveranderlikes; hulle bevat geen werkende aanmeldbesonderhede nie. Kontroleer status.code in die JSON-liggaam sowel as die HTTP-status. Hierdie verouderde hanteerders stel nie konsekwent 'n HTTP-foutstatus vir 'n toepassingsfout nie.

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

Die vereiste padsegment is die gestoorde internasionale telefoonnommer, nie die UUID daarvan of 'n PBX-uitbreiding nie. Hierdie hanteerder gebruik geen navraagparameters of versoekliggaam nie.

Antwoord

Hierdie antwoordstruktuur dien as voorbeeld; dit is nie rekeningdata of 'n huidige pryskwotasie nie.

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

Nommervelde wat teruggegee word
Veld	Betekenis
`number, uuid, description, isocode`	Die gestoorde telefoonnommer, nommeridentifiseerder sonder afleibare betekenis, beskrywing en landkode.
`config`	Gestoorde velde vir stembestemmings, eksterne aanstuur, die SMS-bestemming en SMS-aanstuur. Hierdie eindpunt wysig hulle nie.
`features`	Gestoorde vlae vir stem-, SMS- en MMS-vermoëns. Daar is geen waarborg dat verouderde gestoorde vlae JSON-Booleaanse waardes is nie.
`status.capacity`	Waardes vir toegewysde en gebruikte kanale, die oorloopinstelling en die gestoorde heffing vir oorskryding. Dit is gestoorde metadata, nie 'n nuwe kapasiteitskwotasie of 'n regstreekse oproeptoets nie.
`status.origination`	Gestoorde metadata oor oproepherkoms. Behandel identifiseerders as waardes sonder afleibare betekenis; moenie toepassingslogika uit interne name aflei nie.
`status.service_active, force_codec, force_dtmf`	Gestoorde velde vir aktivering en mediakonfigurasie. 'n Vlag alleen bewys nie suksesvolle inkomende aflewering nie.
`billing`	Gestoorde waardes vir CNAM, oorloop, hernuwing, persistensie en skepping. Die lees daarvan verander nie hernuwing of ander faktureringinstellings nie.
`price`	Gestoorde opstelpryse, maandelikse pryse, pryse per minuut en minuuttoelaes. Die hanteerder verskaf geen geldeenheidveld of nuwe kwotasie nie. Moenie die geldeenheid uit die voorbeeldwaardes aflei of hulle as 'n huidige aankoopkwotasie gebruik nie.

In vergelyking met inventory, gee hierdie eindpunt ook die volgende terug: needs_registration, vrating, country_id, area_id, provider_id en price.perminute_charges. Dit is verouderde gestoorde waardes, nie 'n afsonderlike antwoord oor identiteitsgoedkeuring nie. Verwysings-ID's moet as waardes sonder afleibare betekenis behandel word; moenie ontdekkings-URL's daaruit saamstel of verskafferkoppelings daaruit aflei sonder die toepaslike ontdekkingsantwoord nie.

Geen ooreenstemmende nommer nie

As geen ooreenstemmende rekord wat nie nietig verklaar is nie vir die geverifieerde rekening gevind word nie, bevat die JSON-liggaam status.code 404 en 'n boodskap wat die volgende bevat: number not found. Moenie op die agtervoegsel met die bronreël staatmaak nie. Kontroleer die gestoorde nommer en inventory voordat jy weer probeer.

Gebruik die resultaat

Hierdie bewerking lees gestoorde data. Dit koop nie 'n nommer, keur nie identiteitsdokumente goed, verander nie 'n bestemming en waarborg nie dat 'n oproep, faks of boodskap afgelewer sal word nie. Toets elke geaktiveerde diens afsonderlik wanneer jy 'n nommer opstel.