Eén aangeschaft nummer uitlezen

Lees één record van een aangeschaft nummer en de bijbehorende opgeslagen configuratie uit. Deze bewerking retourneert een object in plaats van de array van het inventory-endpoint.

Verzoek

Gebruik API-inloggegevens aan de serverzijde via HTTPS. De voorbeelden lezen inloggegevens uit omgevingsvariabelen; ze bevatten geen werkende inloggegevens. Controleer status.code in de JSON-body en controleer ook de HTTP-status. Deze verouderde handlers stellen bij een toepassingsfout niet altijd een HTTP-foutstatus in.

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

Het verplichte padsegment is het opgeslagen internationale telefoonnummer, niet de bijbehorende UUID of een PBX-toestelnummer. Deze handler gebruikt geen queryparameters of verzoekbody.

Antwoord

Dit is een voorbeeld van de structuur van het antwoord, geen accountgegevens of actuele prijsopgave.

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

Geretourneerde nummervelden
Veld	Betekenis
`number, uuid, description, isocode`	Het opgeslagen telefoonnummer, de nummeridentificatie waaruit geen betekenis mag worden afgeleid, de beschrijving en de landcode.
`config`	Opgeslagen velden voor spraakbestemmingen, externe doorschakeling, de sms-bestemming en sms-doorsturing. Dit endpoint wijzigt deze velden niet.
`features`	Opgeslagen indicatoren voor ondersteuning van spraak, sms en mms. Er is geen garantie dat deze verouderde opgeslagen indicatoren booleaanse JSON-waarden zijn.
`status.capacity`	Waarden voor toegewezen en gebruikte kanalen, de overloopinstelling en het opgeslagen tarief voor overschrijding. Dit zijn opgeslagen metagegevens, geen nieuwe capaciteitsopgave of test met een live oproep.
`status.origination`	Opgeslagen metagegevens over de oproepherkomst. Leid geen betekenis af uit identificatoren; baseer geen toepassingslogica op interne namen.
`status.service_active, force_codec, force_dtmf`	Opgeslagen velden voor activering en mediaconfiguratie. Een indicator op zichzelf bewijst niet dat inkomend verkeer succesvol wordt afgeleverd.
`billing`	Opgeslagen waarden voor CNAM, overloop, verlenging, persistentie en aanmaak. Het uitlezen ervan wijzigt de instellingen voor verlenging of andere factureringsinstellingen niet.
`price`	Opgeslagen aansluitkosten, maandprijzen, tarieven per minuut en minutentegoeden. De handler levert geen valutaveld of nieuwe prijsopgave. Leid de valuta niet af uit de voorbeeldwaarden en gebruik deze waarden niet als actuele aankoopofferte.

Vergeleken met inventory retourneert dit endpoint ook needs_registration, vrating, country_id, area_id, provider_id en price.perminute_charges. Dit zijn verouderde opgeslagen waarden, geen afzonderlijk antwoord over identiteitsgoedkeuring. Leid geen betekenis af uit referentie-ID's; stel er geen discovery-URL's mee samen en leid er geen koppelingen met providers uit af zonder het bijbehorende discovery-antwoord.

Geen overeenkomend nummer

Als voor het geauthenticeerde account geen overeenkomend, niet-vervallen record wordt gevonden, bevat de JSON-body status.code 404 en een bericht met daarin number not found. Vertrouw niet op het achtervoegsel dat naar een broncoderegel verwijst. Controleer het opgeslagen nummer en inventory voordat u het opnieuw probeert.

Het resultaat gebruiken

Deze bewerking leest opgeslagen gegevens uit. Ze koopt geen nummer, keurt geen identiteitsdocumenten goed, wijzigt geen bestemming en garandeert niet dat een oproep, fax of bericht wordt afgeleverd. Test elke ingeschakelde dienst afzonderlijk bij het configureren van een nummer.