REST API – Dokumentation & Integration
Integrer SMS direkte i dine egne systemer via Mobitech Telecom ApS' sikre REST API. API'et er udviklet med fokus på høj driftssikkerhed, datasikkerhed og enkel integration.
🚀 Send din første SMS
Brug endpointet nedenfor til at sende en SMS via Mobitech Telecom ApS' REST API. Eksemplet kan kopieres direkte til terminalen og tilpasses med dine egne API-oplysninger.
https://email2sms.dk/cgi/url_api/incoming.cgi
curl -X POST "https://email2sms.dk/cgi/url_api/incoming.cgi" \ --data-urlencode "login=" \ --data-urlencode "password= " \ --data-urlencode "api_token= " \ --data-urlencode "action=send" \ --data-urlencode "to=4512345678" \ --data-urlencode "from=mobitech" \ --data-urlencode "text=Test message"
✓ Forventet response
REF_ID: 12345678 result: 200 OK
REF_ID er den unikke reference for beskeden. 200 OK bekræfter, at anmodningen er modtaget og accepteret af platformen. Det er ikke i sig selv en bekræftelse på, at SMS'en er leveret til modtagerens telefon.
📋 Parameteroversigt
Følgende parametre anvendes ved afsendelse af SMS via REST API. Alle værdier skal URL-encodes ved brug af GET eller sendes som POST-data.
| Parameter | Type | Påkrævet | Beskrivelse | Eksempel |
|---|---|---|---|---|
| login | String | Ja | Brugernavn valgt ved kontooprettelse. | demo |
| password | String | Ja | API Password (ikke det samme som login-password). | ******** |
| api_token | String | Ja | Unik API Token fra Konto → API & Integration. | abc123... |
| action | Enum | Ja | Handling der ønskes udført. | send |
| to | MSISDN | Ja | Mobilnummer inkl. landekode. | 4512345678 |
| from | String | Valgfri | Afsendernavn eller nummer afhængigt af kontooplysninger. | Mobitech |
| text | UTF-8 | Ja | SMS-beskeden. Specialtegn skal URL-encodes. | Test message |
⚠️ Response & Fejlkoder
REST API returnerer en status, som angiver, om anmodningen blev accepteret eller afvist.
OK
Anmodningen er modtaget og accepteret. En REF_ID returneres og kan anvendes til historik og leveringsstatus.
Bad Request
En eller flere parametre mangler eller indeholder ugyldige værdier.
Unauthorized
Forkert brugernavn, API Password eller API Token.
Forbidden
Adgangen er afvist. Kontroller IP Lock, Geo Fence eller adgangsindstillinger.
Too Many Requests
SMS Rate Limit er overskredet. Kontroller den konfigurerede grænse eller kontakt Mobitech Telecom ApS.
Internal Server Error
Der opstod en intern fejl. Forsøg igen eller kontakt Mobitech Telecom ApS Support, hvis problemet fortsætter.
Gem altid den returnerede REF_ID. Reference-ID'et kan anvendes ved leveringsrapporter, historik, fejlsøgning og kontakt til support.
📚 Klassisk API Reference
Quick Start ovenfor viser den hurtigste vej til integration. Nedenfor finder du den komplette tekniske reference med alle requests, parametre og eksempler. Denne sektion er velegnet som opslagsværk under udvikling.
HTTPS Request – SMS Afsendelse
https://email2sms.dk/cgi/url_api/incoming.cgi
https://email2sms.dk/cgi/url_api/incoming.cgi? login=xx& password=xx& api_token=xx& action=send& to=4512345678& from=mobitech& text=Test message
Parameteroversigt
| Parameter | Beskrivelse |
|---|---|
| login | Brugernavn valgt ved konto-oprettelse |
| password | API-password (ikke det samme som login-password) |
| api_token | Unik token, findes under Konto & Faktura |
| action | Skal sættes til send |
| to | Modtagerens mobilnummer |
| from | Afsendernavn/nummer (sikkerhed + sender overwrite) |
| text | SMS-besked (URL-encoded) |
Response
REF_ID: xxxxxxxx result: 200 OK
REF_ID er den unikke reference for beskeden.
result OK bekræfter kun, at anmodningen blev modtaget korrekt – ikke status på levering.
Tidsstyret SMS Afsendelse (SSD)
https://www.email2sms.dk/cgi/url_api/incoming.cgi? login=xx& password=xx& from=mobitech& action=SSD& send_time=2005-07-04 10:00:00& mobile=4512345678xx& text=test message
Parameteroversigt
| Parameter | Beskrivelse |
|---|---|
| login | Login valgt ved oprettelse af konto |
| password | API-password (ikke det samme som login-password) |
| from | Afsender – ekstra sikkerhed eller sender overwrite |
| action | Skal sættes til SSD (Schedule SMS Delivery) |
| send_time | Tidspunkt for afsendelse (yyyy-mm-dd hh:mm:ss) |
| mobile | Modtagerens mobilnummer |
| text | SMS-besked (URL-encoded) |
Response
REF_ID: xxxxxxxx result: OK
REF_ID er den unikke reference for beskeden.
result OK bekræfter, at anmodningen er modtaget korrekt – ikke leveringsstatus.
Hent Transaktionshistorik
https://www.email2sms.dk/cgi/url_api/incoming.cgi? login=xx& password=xx& action=transaction& lines=10& bg_color=000000& font_color=ffffff& border_color=597795& info=all& ref_id=XX& mobile_req=XX
Parameteroversigt
| Parameter | Beskrivelse |
|---|---|
| login | Login valgt ved oprettelse af konto |
| password | Password valgt ved oprettelse af konto |
| action | Skal sættes til transaction |
| lines | Antal transaktioner der vises (f.eks. 10) |
| bg_color | Baggrundsfarve (RGB hex) |
| font_color | Tekstfarve (RGB hex) |
| border_color | Rammefarve (RGB hex) |
| info | Sættes til all for fuld returinformation (ellers kun tid + besked) |
| mobile_req | Filter på specifikt mobilnummer (valgfrit) |
| ref_id | Filter på specifik reference ID (valgfrit) |
Response
"timestamp": "2025-01-18 14:22:01",
"mobile": "4512345678",
"sender": "Firmanavn",
"text": "Eksempel på besked",
"status": "DELIVERED",
"ref_id": "A1B2C3D4"
result: 200 OK
Når info=all returneres alle felter for hver transaktion.
Du kan filtrere efter mobilnummer (mobile_req) eller reference ID (ref_id).
API Token – Sikkerheds- og Adgangsmodel
Et API Token fungerer som en unik digital nøgle, der giver adgang til Mobitech’s REST og URL API.
Token-baseret adgang giver et højere sikkerhedsniveau end traditionelt login/password,
og er designet til stabil drift, automatiserede systemer og høj volumen.
API Token kan benyttes alene, eller i kombination med login og password som ekstra sikkerhedslag.
Tokenet findes under Konto & Faktura på app.mobitech.dk.
https://email2sms.dk/cgi/url_api/incoming.cgi? login=xx& password=xx& api_token=abcdef1234567890& action=send& to=4512345678& from=mobitech& text=Test message
Token Parametre og Funktion
| Parameter | Beskrivelse |
|---|---|
| api_token | Unik API-nøgle genereret til din konto (findes under Konto & Faktura) |
| login | Valgfrit når token bruges – kan dog benyttes som ekstra sikkerhed |
| password | Valgfrit ved token-login – ikke det samme som login-password til app |
Sikkerhedsfordele
- Høj sikkerhed – token er langt sværere at gætte eller brute-force end password
- Kan nulstilles øjeblikkeligt, hvis det kompromitteres
- Kan bruges uden login/password for automatiske systemintegrationer
- Understøtter IP Lock (låser tokenet til dine server-IP’er)
- Ideelt til API-drift, cronjobs, ERP-systemer, IoT, gateways m.m.
Sender / Sender Overwrite
Sender er den afsenderidentitet, der vises på modtagerens telefon.
Det kan være et mobilnummer eller et alfanumerisk navn
(fx “FIRMAINFO”).
Sender Overwrite gør det muligt at tilsidesætte standardafsenderen,
som er tilknyttet kontoen, og i stedet angive en anden afsender direkte i API-kaldet.
Funktionen er særlig nyttig, når forskellige afdelinger, systemer eller brands deler samme konto,
men ønsker at afsende med egne afsendernavne.
https://email2sms.dk/cgi/url_api/incoming.cgi? login=xx& password=xx& api_token=xx& action=send& to=4512345678& from=mobitech& text=Test message
Parameteroversigt
| Parameter | Beskrivelse |
|---|---|
| from | Angiver afsenderen. Kan være:
Sender Overwrite tilsidesætter kontoens standardsender, hvis funktionen er aktiveret. |
| login | Login valgt ved oprettelse af konto |
| password | API-password (ikke det samme som login-password) |
| api_token | Unik token, bruges til API-autentificering |
| action | Skal sættes til send for afsendelse af SMS |
Response
REF_ID: xxxxxxxx result: 200 OK
Sikkerhedsforhold
- Afsendernavne valideres og godkendes manuelt intern sikkerheds procedure.
- Overwrite kræver aktivering på kontoen af sikkerhedshensyn.
- Overvågning sikrer, at afsender ikke misbruges uautoriseret.
- IP Lock og API Token er et krav ved sender-overwrite.
FÅ SVAR PÅ DINE SPØRGSMÅL
Ofte stillede spørgsmål !
Testkonto på få minutter
Du kan enkelt oprette din egen testkonto, og være igang med dine første beskeder på få minutter
Test alle vores funktioner GRATIS
Med en demo konto åbner vi op for at du kan teste det hele af gratis i 8 dage
Online leverings status
Du har altid 100% adgang til online SMS historik, hvor du kan se leveringsstatus på dine beskeder
Prøveperiode – Din Fordel.
Vores erfaringer med vores kunder er ønsket om at få lov til at prøve funktionerne, således der opnår kendskab til fordelene ved de forskellige funktioner.
Du kan med fordel afprøve alle vores produkter i 8 dage.
GRATIS for dig.
Vi stiller GRATIS de SMS beskeder du skal bruge til din rådighed.
Du bestemmer selv.
Du har mulighed for selv at bestemme afsender på beskeden.
Det betyder at du enten akn lade afsender være dit firmanavn eller et nummer der kan besvares.
Besvarelse fra dine brugere.
Der er ligeledes mulighed for at opsætte besvarelses funktioen der gør dine brugere istand til at besvare dine beskeder.
Adgang til hele verden.
Vores platforme åbner op så du får adgang til alle mobilbrugere i verden.
Roaming i andre lande
Vores systemer finder selv frem til hvor mobilbrugeren befinder sig,
og leverer beskeden korrekt og uden forsinkelser.
Online leverings status
Du har altid 100% adgang til online SMS historik, hvor du kan se leveringsstatus på dine beskeder
