Læs ét købt nummer

Læs én post for et købt nummer og dens gemte konfiguration. Denne handling returnerer et objekt i stedet for det array, som inventory-endepunktet returnerer.

Anmodning

Brug API-legitimationsoplysninger på serversiden via HTTPS. Eksemplerne læser legitimationsoplysninger fra miljøvariabler; de indeholder ingen fungerende legitimationsoplysninger. Kontrollér status.code i JSON-indholdet samt HTTP-statussen. Disse ældre handlere angiver ikke konsekvent en HTTP-fejlstatus ved en applikationsfejl.

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

Det påkrævede stisegment er det gemte internationale telefonnummer, ikke dets UUID eller et PBX-lokalnummer. Denne handler bruger hverken forespørgselsparametre eller indhold i anmodningen.

Svar

Dette er et eksempel på svarets struktur, ikke kontodata eller et aktuelt 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"
  }
}

Returnerede nummerfelter
Felt	Betydning
`number, uuid, description, isocode`	Det gemte telefonnummer, nummerets identifikator uden fortolkelig betydning, beskrivelsen og landekoden.
`config`	Gemte felter for taledestinationer, ekstern viderestilling, SMS-destination og SMS-videresendelse. Dette endepunkt ændrer dem ikke.
`features`	Gemte flag for understøttelse af tale, SMS og MMS. Ældre gemte flag er ikke nødvendigvis booleske JSON-værdier.
`status.capacity`	Værdier for tildelte og anvendte kanaler, overløbsindstilling og gemt gebyr for overforbrug. Dette er gemte metadata, ikke et nyt kapacitetstilbud eller en opkaldstest i realtid.
`status.origination`	Gemte metadata om opkaldsoprindelse. Behandl identifikatorer som værdier uden fortolkelig betydning; udled ikke applikationslogik af interne navne.
`status.service_active, force_codec, force_dtmf`	Gemte felter for aktivering og mediekonfiguration. Et flag alene beviser ikke, at indgående trafik leveres korrekt.
`billing`	Gemte værdier for CNAM, overløb, fornyelse, persistens og oprettelse. Aflæsning af dem ændrer ikke fornyelse eller andre faktureringsindstillinger.
`price`	Gemte oprettelsespriser, månedspriser, minutpriser og minuttildelinger. Handleren leverer hverken et valutafelt eller et nyt tilbud. Udled ikke valutaen af eksempelværdierne, og brug dem ikke som et aktuelt købstilbud.

Sammenlignet med inventory returnerer dette endepunkt også needs_registration, vrating, country_id, area_id, provider_id og price.perminute_charges. Dette er ældre gemte værdier, ikke et særskilt svar om identitetsgodkendelse. Reference-id'er skal behandles som værdier uden fortolkelig betydning; konstruér ikke URL'er til opslag, og udled ikke tilknytninger til udbydere af dem uden det relevante opslagssvar.

Intet matchende nummer

Hvis der ikke findes en matchende, ikke-annulleret post for den autentificerede konto, indeholder JSON-indholdet status.code 404 og en meddelelse, der indeholder number not found. Stol ikke på meddelelsens suffiks med kildekodelinjen. Kontrollér det gemte nummer og inventory, før du prøver igen.

Brug resultatet

Dette er en læsning af gemte data. Den køber ikke et nummer, godkender ikke identitetsdokumenter, ændrer ikke en destination og garanterer ikke, at et opkald, en fax eller en meddelelse bliver leveret. Test hver aktiveret tjeneste separat, når du konfigurerer et nummer.