Bestill telefonnumre fra et prefiks

Bestill fra et prefiks

Bruk denne operasjonen når prefikskatalogen viser at du skal bestille et antall numre fra et prefiks i stedet for å velge enkelte tilgjengelige numre. Begynn med land, områder eller delstater, og prefikser. Behold prefiksidentifikatoren og prisplanen fra det samme ferske resultatet. For et bestemt nummer valgt fra en liste over tilgjengelige numre bruker du Kjøp et valgt telefonnummer.

Denne forespørselen kan kjøpe numre og medføre kostnader. Den er ikke et pristilbud, en reservasjon eller en prøvekjøring. Gå gjennom etablerings- og månedspriser, minuttpriser for innkommende samtaler, inkluderte minutter, kanaler, registreringskrav og kontoens kjøpsgrenser før du sender den. Et katalogresultat reserverer ikke numre og låser ikke priser. Kontroller knyttet til påfylling av kontoen kan skje før kjøpet fullføres; en feil beviser ikke i seg selv at det ikke har skjedd et kjøp eller en påfylling av kontoen.

Send inn kjøpet

Bruk en aktivert API-konto over HTTPS fra en tillatt kilde-IP-adresse. Angi variablene ut fra det gjeldende katalogvalget og den godkjente leveringskonfigurasjonen din. Følgende kommando kjøper ett nummer.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode 'quantity=1' \
  --data-urlencode "price_id=$PRICE_ID" \
  --data-urlencode "channels=$CHANNELS" \
  --data-urlencode "reference=$ORDER_REFERENCE" \
  --data-urlencode "uri=$VOICE_URI" \
  "https://api.multitel.net/v3/order/$PREFIX_ID"

POST med skjemadata er vist ovenfor. Koordinatoren leser også et JSON-objekt når Content-Type er application/json. JSON-felter overstyrer tilsvarende felt i skjemaet/forespørselen. Bruk én koding konsekvent; ikke send motstridende verdier i spørringsparametrene og forespørselskroppen.

Innstillinger for levering og fornyelse

Velg de samme leveringsinnstillingene som du ville brukt for nummeret i portalen. Dette er avanserte konfigurasjonsverdier, ikke instruksjoner for å opprette en driftet telefonsentral eller en trunk for innkommende telefoni. Gjenbruk en kontokonfigurasjon som du vet fungerer, og kontroller det lagrede nummeret etter kjøpet. Et godkjent kjøp bekrefter ikke i seg selv at levering av tale eller SMS fungerer.

Disse feltene normaliseres og sendes videre til kjøpsbehandlingen, men hva som lagres, varierer mellom flytene for ulike nummerbeholdninger. Den gjeldende bestillingsruten tilbyr ikke de strenge feltene for pristilbudsgrenser fra veiledningen for kjøp av et valgt nummer som tilsvarende vern. Bruk kontoens kjøpstillatelser og prisgrenser, og kontroller den resulterende nummerkonfigurasjonen.

Les hele resultatet

Tolk JSON-kroppen og kontroller status.code og status.msg selv når HTTP-forespørselen lykkes. Denne ruten skriver sitt eget JSON-svar, og den felles svarhjelperen kobler heller ikke nødvendigvis applikasjonskoden til HTTP-statusen. Applikasjonskoder kan være JSON-tall eller numeriske strenger. Ikke krev status.results; feltet finnes ikke i det vanlige bestillingsresultatet.

{
  "status": {"code": "200", "msg": ""},
  "response": {
    "id": "o_fictional_example",
    "numbers": ["12025550123"],
    "price": {
      "per_minute": "0.01",
      "free_minutes": 0,
      "setup_price": "1.25",
      "monthly_price": "2.50",
      "channels": 2
    },
    "features": ["voice"],
    "needs_registration": 0,
    "restrictions": "",
    "registration_requirements": null
  }
}

Identifikatoren, nummeret og prisene ovenfor er oppdiktet. Behandle bestillings-ID-en som en ugjennomsiktig verdi. numbers lister opp numrene som dette svaret oppgir som kjøpt; sammenlign lengden på listen med antallet du ba om. Prisbeløp er strenger, og dette svaret avrunder pengesatser til to desimaler, inkludert per_minute; bruk den ferske katalogen for den opprinnelige prisnøyaktigheten. Inkluderte minutter og kanaler kan komme som tallverdier eller numeriske strenger.

Prisblokken beskriver den valgte planen som ble brukt til å bygge svaret, ikke en detaljert faktura for hvert nummer eller bestillingens totalbeløp. Ulike kandidater i nummerbeholdningen kan ha ulike planer. Avstem de enkelte kjøpte numrene og kontotransaksjonene i stedet for å multiplisere beløpene i denne blokken og anta at det beviser det endelige totalbeløpet.

Delvise kjøp og usikre utfall

En applikasjonskode på 200 kan komme sammen med en advarsel og færre numre enn forespurt. En senere feil opphever ikke kjøp av numre som allerede er kjøpt. Ta vare på den returnerte bestillings-ID-en, numrene og meldingen. Avstem disse numrene mot nummerbeholdningen din og kontotransaksjonene før du avgjør om du skal bestille et gjenstående antall.

Et tidsavbrudd, en brutt forespørsel, et feilformatert svar eller en feil etter innsending er ikke bevis på at ingenting skjedde. Ikke send inn et nytt kjøp automatisk, selv med samme referanse. Ta vare på den opprinnelige forespørselen, referansen og eventuell returnert bestillings-ID, kontroller nummerbeholdningen og kontotransaksjonene, og kontakt kundestøtte hvis utfallet fortsatt er usikkert.

En ubekreftet bestilling kan returnere applikasjonskode 400 med en melding om at den fortsatt er under bekreftelse. Ta vare på den returnerte bestillings-ID-en og avstem kjøpet; dette er ikke en instruksjon om å sende det inn på nytt. Gjenopprettingen av registrerte bestillinger følger den opprinnelige bestillingen internt. En ny forespørsel til denne operasjonen oppretter et separat kjøpsforsøk i stedet for å gjenoppta en bestilling ut fra referansen din, og kan derfor kjøpe og belaste for flere numre. Ikke bruk gjentatte kjøpsforespørsler til å kontrollere status eller søke i nummerbeholdningen.

Registrering og aktivering

Et kjøpt eller tildelt nummer kan fortsatt kreve registrering eller aktivering. Hvis needs_registration er 1, kontrollerer du restrictions og registration_requirements. Sistnevnte kan angi v3/get_requirements med verdier for country og number_type. Fullfør den aktuelle prosessen for identitets-/adressekontroll, og bekreft nummerets status før du baserer deg på innkommende samtaler eller meldinger.

features beskriver oppgitte funksjoner; det bekrefter ikke at ruting fungerer i drift, at kampanjer er godkjent, at SMS leveres eller at faks mottas. Kontroller de lagrede leveringsinnstillingene, og utfør den aktuelle tjenestetesten når nummeret er aktivt.

Tilbakekall for bestillinger

Tilbakekall sender JSON med POST, med bestillingens status og svar samt referansen din hvis den er oppgitt. De sendes for rapporterte kjøp, inkludert delvise resultater. Et mislykket tilbakekall reverserer ikke kjøpet. Levering kan forsøkes på nytt, så håndter duplikater etter bestillings-ID og avstem numrene i stedet for å sende inn et nytt kjøp.

Denne ruten legger ikke til en kryptografisk signatur i tilbakekallet. Behandle et tilbakekall som et varsel som skal avstemmes mot nummerbeholdningen du har tilgang til gjennom autentisering, ikke som en selvstendig tillatelse til å belaste, klargjøre tjenester eller gi tilgang. Ikke legg API-påloggingsopplysninger i URL-en for tilbakekall. Hvis du sender inn et nytt kjøp med en annen URL for tilbakekall, oppdateres ikke den opprinnelige bestillingen; det opprettes et separat kjøpsforsøk. Ta vare på den opprinnelige bestillings-ID-en når du ber kundestøtte undersøke tilbakekallet.

Feil som må håndteres