Hent ett kjøpt nummer

Hent én oppføring for et kjøpt nummer og den lagrede konfigurasjonen. Denne operasjonen returnerer et objekt i stedet for en matrise slik endepunktet inventory gjør.

Forespørsel

Bruk API-påloggingsopplysninger på serversiden over HTTPS. Eksemplene leser påloggingsopplysninger fra miljøvariabler; de inneholder ingen fungerende påloggingsopplysninger. Kontroller status.code i JSON-innholdet i tillegg til HTTP-statusen. Disse eldre forespørselsbehandlerne setter ikke konsekvent en HTTP-feilstatus ved en applikasjonsfeil.

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

Det påkrevde stisegmentet er det lagrede internasjonale telefonnummeret, ikke nummerets UUID eller et internnummer i en telefonsentral. Denne forespørselsbehandleren bruker verken spørringsparametere eller forespørselsinnhold.

Svar

Dette illustrerer svarstrukturen og er verken kontodata eller et gjeldende pristilbud.

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

Returnerte nummerfelt
Felt	Betydning
`number, uuid, description, isocode`	Det lagrede telefonnummeret, nummeridentifikatoren som skal behandles uten å tolke innholdet, beskrivelsen og landskoden.
`config`	Lagrede felt for taleanropsmål, ekstern viderekobling, SMS-mål og SMS-videresending. Dette endepunktet endrer dem ikke.
`features`	Lagrede flagg for støtte for tale, SMS og MMS. Det er ikke garantert at eldre lagrede flagg er boolske JSON-verdier.
`status.capacity`	Verdier for tildelte og brukte kanaler, innstilling for overløp og lagret gebyr for overforbruk. Dette er lagrede metadata, ikke et nytt kapasitetstilbud eller en sanntidstest av anrop.
`status.origination`	Lagrede metadata om anropsopprinnelse. Behandle identifikatorer uten å tolke innholdet; ikke utled applikasjonslogikk fra interne navn.
`status.service_active, force_codec, force_dtmf`	Lagrede felt for aktivering og mediekonfigurasjon. Et flagg alene bekrefter ikke at innkommende trafikk blir levert.
`billing`	Lagrede verdier for CNAM, overløp, fornyelse, varighet og opprettelse. Å lese dem endrer ikke fornyelse eller andre faktureringsinnstillinger.
`price`	Lagrede etableringspriser, månedspriser, minuttpriser og inkluderte minutter. Forespørselsbehandleren gir verken et valutafelt eller et nytt pristilbud. Ikke utled valutaen fra eksempelverdiene eller bruk dem som et gjeldende pristilbud ved kjøp.

Sammenlignet med inventory returnerer dette endepunktet også needs_registration, vrating, country_id, area_id, provider_id og price.perminute_charges. Dette er eldre lagrede verdier, ikke et eget svar om identitetsgodkjenning. Referanse-ID-er bør behandles uten å tolke innholdet; ikke konstruer URL-er for oppslag eller utled leverandørkoblinger fra dem uten det relevante oppslagssvaret.

Ingen samsvarende numre

Hvis det ikke finnes noen samsvarende oppføring som ikke er annullert, for den autentiserte kontoen, har JSON-innholdet status.code 404 og en melding som inneholder number not found. Ikke baser deg på suffikset som angir linjen i kildekoden. Kontroller det lagrede nummeret og inventory før du prøver igjen.

Bruk resultatet

Dette er en lesing av lagrede data. Operasjonen kjøper ikke et nummer, godkjenner ikke identitetsdokumenter, endrer ikke et mål og garanterer ikke at et anrop, en faks eller en melding blir levert. Test hver aktiverte tjeneste separat når du konfigurerer et nummer.