Läs ett köpt nummer

Läs en post för ett köpt nummer och dess lagrade konfiguration. Den här operationen returnerar ett objekt i stället för den array som ändpunkten inventory returnerar.

Begäran

Använd API-autentiseringsuppgifter på serversidan över HTTPS. Exemplen läser autentiseringsuppgifter från miljövariabler; de innehåller inga fungerande autentiseringsuppgifter. Kontrollera status.code i JSON-svarskroppen samt HTTP-statusen. Dessa äldre hanterare anger inte konsekvent en HTTP-felstatus vid ett applikationsfel.

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

Det obligatoriska sökvägssegmentet är det lagrade internationella telefonnumret, inte dess UUID eller en växelanknytning. Den här hanteraren använder inga frågeparametrar och ingen begärandekropp.

Svar

Detta är ett exempel på svarets struktur, inte kontouppgifter eller en aktuell prisoffert.

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

Returnerade nummerfält
Fält	Betydelse
`number, uuid, description, isocode`	Det lagrade telefonnumret, en nummeridentifierare vars innehåll inte ska tolkas, beskrivningen och landskoden.
`config`	Lagrade fält för röstdestinationer, extern vidarekoppling, SMS-destination och vidarebefordran av SMS. Den här ändpunkten ändrar dem inte.
`features`	Lagrade flaggor för stöd för röst, SMS och MMS. Det finns ingen garanti för att äldre lagrade flaggor är booleska JSON-värden.
`status.capacity`	Värden för tilldelade och använda kanaler, överflödesinställning och lagrad avgift för överförbrukning. Detta är lagrade metadata, inte en ny kapacitetsoffert eller ett test med ett faktiskt samtal.
`status.origination`	Lagrade metadata om samtalsursprung. Behandla identifierare som värden vars innehåll inte ska tolkas; härled inte applikationslogik från interna namn.
`status.service_active, force_codec, force_dtmf`	Lagrade fält för aktivering och mediekonfiguration. En flagga i sig bevisar inte att inkommande trafik levereras korrekt.
`billing`	Lagrade värden för CNAM, överflöde, förnyelse, beständighet och skapande. Att läsa dem ändrar inte förnyelse eller andra faktureringsinställningar.
`price`	Lagrade startavgifter, månadspriser, minutpriser och minutpotter. Hanteraren tillhandahåller varken något valutafält eller en ny offert. Härled inte valutan från exempelvärdena och använd dem inte som en aktuell inköpsoffert.

Jämfört med inventory returnerar den här ändpunkten även needs_registration, vrating, country_id, area_id, provider_id och price.perminute_charges. Dessa är äldre lagrade värden, inte ett separat svar om godkännande av identitet. Referens-ID:n ska behandlas som värden vars innehåll inte ska tolkas; skapa inte URL:er för upptäckt och härled inte kopplingar till leverantörer från dem utan motsvarande upptäcktssvar.

Inget matchande nummer

Om ingen matchande post som inte är makulerad hittas för det autentiserade kontot har JSON-svarskroppen status.code 404 och ett meddelande som innehåller number not found. Förlita dig inte på dess suffix med källkodsrad. Kontrollera det lagrade numret och inventory innan du försöker igen.

Använd resultatet

Detta är en läsning av sparade data. Den köper inte ett nummer, godkänner inte identitetshandlingar, ändrar inte en destination och garanterar inte att ett samtal, fax eller meddelande levereras. Testa varje aktiverad tjänst separat när du konfigurerar ett nummer.