Beregn SMS-kodning og segmenter

Analysér den præcise beskedtekst

Beregn kodningen, den kodede længde og antallet af SMS-segmenter for den tekst, du vil sende. Dette endpoint sender ikke en SMS, reserverer ikke en rute og returnerer ikke et pristilbud på levering. Indsend hele den endelige tekst, inklusive eventuel sidefod, link eller formulering om afmelding, som din afsendelsesproces tilføjer.

Anmodning

Autentificér dig med din aktiverede API-konto og dens tilladte kilde-IP-adresse. Opbevar legitimationsoplysninger i et hemmelighedslager på serversiden. Send en UTF-8-streng i feltet text; eksemplet bruger miljøvariabler.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode 'text=Your message here' \
  https://api.multitel.net/v3/smslength

Formularkodet input understøttes. Et JSON-objekt som {"text":"Your message here"} accepteres også, når der ikke angives formularfelter eller forespørgselsfelter. Brug helst POST, så beskedteksten ikke vises i en URL. Hvis der både er formularinput og forespørgselsinput, bruges formularen. Bland ikke anmodningsformater.

Svar

{
  "status": {
    "code": "200",
    "msg": ""
  },
  "response": {
    "charset": 0,
    "encoding": "GSM-7",
    "count": 1,
    "parts": 1,
    "chars": 17,
    "units": 17,
    "single_limit": 160,
    "multipart_limit": 153
  }
}

Felter i beregnerens resultat
Felt	Betydning
charset	0 for GSM-7 eller 2 for UTF-16.
encoding	GSM-7 eller UTF-16.
parts, count	To navne for det beregnede antal SMS-segmenter. Begge er nul ved tom tekst.
units, chars	To navne for kodede enheder. De svarer ikke nødvendigvis til antallet af synlige tegn.
single_limit	Grænsen for antal kodede enheder i et enkelt segment med den valgte kodning.
multipart_limit	Grænsen for antal kodede enheder i hvert segment, når der er taget højde for den ekstra plads til sammenkædning.

Kodning og segmentgrænser

Grænser, som beregneren bruger
Kodning	Enkelt segment	Segment i en besked med flere dele
GSM-7	160 septetter	153 septetter
UTF-16	70 kodeenheder	67 kodeenheder

Udvidelsestegn i GSM-7 såsom ^, krøllede parenteser, kantede parenteser, omvendt skråstreg, lodret streg, tilde og eurotegnet bruger to septetter. Et tegn uden for GSM-7 får hele beskeden til at blive talt i UTF-16. En emoji uden for det grundlæggende flersprogede plan bruger to UTF-16-enheder; en synlig emojisekvens kan indeholde flere kodepunkter.

For eksempel kan 160 almindelige GSM-7-bogstaver være i ét segment, mens 161 kræver to. Firs ^-tegn bruger 160 enheder og kan være i ét segment; enogfirs bruger 162 enheder og kræver to. Femogtredive simple emojier uden for BMP bruger 70 UTF-16-enheder og kan være i ét segment; seksogtredive bruger 72 enheder og kræver to. Kombinerende tegn og sammenkædede emojier kan ændre disse antal.

Fejl og tom tekst

Et manglende text-felt, et array/objekt i stedet for en skalarværdi eller ugyldig UTF-8 returnerer API-koden 403. Læs JSON-felterne status.code og status.msg samt HTTP-statussen; dette endpoint returnerer koden som en streng. En tom streng er gyldig og returnerer nul enheder og nul segmenter.

Brug resultatet før afsendelse

Den gennemgåede beregner indeholder ingen afsendelse af beskeder, kald til teleoperatører eller debitering af kontoen. Resultatet er en analyse af den indsendte tekst, ikke en leveringsgaranti eller en endelig regning. Afsendelse kan være forbundet med destinationsafhængige takster, operatørgebyrer, kampagnekrav og yderligere ændringer af teksten. Beregn igen, når du har ændret beskeden, og brug derefter den godkendte afsendelsesproces og kontoens aktuelle priser.