API: Sende SMS og MMS

Alle kunder hos Sveve har tilgang til et API (Application Programming Interface) for utsendelse av SMS (og MMS dersom man har avtale om dette). Dette kan benyttes til å integrere SMS i egne løsninger.
Eksempel:
http://www.sveve.no/SMS/SendMessage?user=sveve&to=91759701&msg=Tester%20SMS

Parametere:
  • user*: kundens brukernavn
  • to*: mottakers mobilnummer (kommaseparert ved flere), og/eller navn på en eksisterende gruppe
  • msg*: meldingsteksten 1)
  • passwd: passord (krever at https benyttes som protokoll, alternativt kan vi filtrere på IP adresse)
  • from: avsender (navn (maks 11 tegn) eller mobilnummer)2)
  • reply: meldingen skal kunne besvares (true/false)2)
  • price: pris i øre ved taksering 3)
  • date_time: dato/klokkeslett for utsendelse 4)
  • reoccurrence: gjentakelse 5)
  • img_url*: URL til bildet som skal sendes 6)
1) Det forutsettes at teksten er UTF-8 encoded. Maks. 612 tegn (4 SMS).
2) Gjelder ikke for MMS
3) Krever tilgang til taksering. Gyldige verdier: 100, 200, 300, 400, ...
4) Krever tilgang til SveveVarsling. Format: yyyyMMddttmm. Eksempel: 201010061315 (6. okt. 2010 kl. 13:15)
5) Krever tilgang til SveveVarsling. Format: value|unit (unit: 11 = time, 5 = dag, 99 = uke, 2 = måned)
6) Gjelder for MMS, bildet kan være maks. 80 kilobyte

XML retur

Retur fra en http push er XML.

Eksempel 1:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<sms>
<response>
  <msg_ok_count>0</msg_ok_count>
  <errors>
    <fatal>Feil brukernavn/IP (sveve, 48.62.40.19)</fatal>
  </errors>
</response>
</sms>

Eksempel 2:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<sms>
<response>
  <msg_ok_count>0</msg_ok_count>
  <errors>
    <error>
      <number>9175970</number>
      <message>Telefonnummeret består av for få siffer</message>
    </error>
  </errors>
</response>
</sms>

Eksempel 3:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<sms>
<response>
  <msg_ok_count>2</msg_ok_count>
  <ids>
    <id>66342</id>
    <id>66343</id>
  </ids>
</response>
</sms>

Returen inneholder antall meldinger som ble sendt (<msg_ok_count>), samt evt. feilmeldinger og meldings-ID.