Routeringsinformatie opvragen

Vraag routeringsinformatie op voor een Noord-Amerikaans telefoonnummer. Gebruik deze informatie om beschikbare routeringsgegevens en gegevens over de telecomaanbieder te interpreteren, niet als bewijs van de identiteit van de abonnee, eigendom van het nummer, bereikbaarheid of beschikbaarheid voor aankoop. Voor een opvraging kunnen kosten op uw account in rekening worden gebracht.

Verzoek

Gebruik uw ingeschakelde API-account en het daarvoor toegestane bron-IP-adres. Geef het volledige nummer op als cijfers, inclusief landcode 1. Het voorbeeld gebruikt omgevingsvariabelen en een fictief nummer. De verwerkingsroutine normaliseert leestekens niet; controleer de invoer voordat u deze verstuurt.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/lrn/12025550123

Antwoord

Alleen enkele velden worden ter illustratie getoond; de beschikbaarheid hangt af van de bron en het nummertype.

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

Bij een standaardopvraging worden de namen van de geretourneerde velden omgezet naar kleine letters. Afhankelijk van de bron kunnen velden voor de telecomaanbieder, het tariefgebied, de locatie en het rechtsgebied aanwezig zijn. Het antwoord is geen volledig abonneerecord met een vaste samenstelling. De vlag local kan de numerieke waarde 1 of de tekenreekswaarde 0 hebben. De verwerkingsroutine berekent ported door het geretourneerde routeringsnummer te vergelijken met het opgegeven telefoonnummer; beschouw dit niet als een geverifieerde volledige geschiedenis van nummerporteringen.

Prijs en herhaalde verzoeken

De beoordeelde verwerkingsroutine schrijft $0.00025 van het account af wanneer het afrondingspad wordt bereikt en de opvraging wordt geregistreerd. De geretourneerde kosten worden doorgaans weergegeven als een tekenreeks met het dollarteken, in plaats van als uitsluitend een numeriek bedrag. Er wordt geen idempotentiesleutel beschikbaar gesteld. Als u een verzoek herhaalt, kunnen opnieuw kosten in rekening worden gebracht.

Voor prepaidaccounts controleert de code of het saldo ten minste 0.00025 bedraagt. De melding over onvoldoende saldo vermeldt momenteel $5, wat niet overeenkomt met die drempel. Beschouw deze fout als een afwijzing vanwege het saldo en controleer het beschikbare tegoed op het account voordat u het opnieuw probeert.

Fouten en onvolledige succesvolle antwoorden

Controleer zowel de HTTP-status als status.code/status.msg in JSON. Een leeg resultaat van een standaardopvraging geeft API-code 404 terug. API-code 403 kan wijzen op onvoldoende prepaidtegoed.

Een huidig foutpad voor gratis te bellen nummers kan toch het bedrag voor de opvraging afschrijven en API-code 200 teruggeven zonder bruikbare routeringsvelden; de kosteninformatie kan onvolledig zijn. Alleen code 200 betekent dus niet dat de opvraging bruikbaar is. Controleer de velden die uw toepassing nodig heeft, vergelijk onduidelijke afschrijvingen met de factureringsgegevens van het account en neem bij onvolledige resultaten contact op met de ondersteuning.

In de beoordeelde implementatie verschilt de verwerking van gratis te bellen nummers naargelang de lengte van de invoer. Gebruik bij voorkeur het volledige internationale nummer, uitsluitend in cijfers, en controleer bij de ondersteuning of de benodigde gratis te bellen nummers worden ondersteund. Herhaal een verzoek niet automatisch bij een onjuist opgebouwd of onvolledig resultaat en baseer de beslissing of het veilig en toegestaan is om een nummer te bellen niet op een opvraging van routeringsinformatie.