Sendega API documentation.pdf - GetACoder

FRA 

1

CONTENTS 

Sendega API documentation ................................................................................................................................... 4 

Introduction ........................................................................................................................................................ 4 

Overview ............................................................................................................................................................. 4 

Security ........................................................................................................................................................... 4 

Formats and standards ................................................................................................................................... 4 

Send SMS and MMS ................................................................................................................................................ 5 

Examples ............................................................................................................................................................. 6 

Return values ...................................................................................................................................................... 7 

Error codes .......................................................................................................................................................... 7 

Send WAP PUSH ...................................................................................................................................................... 8 

Example ............................................................................................................................................................... 8 

Error codes .......................................................................................................................................................... 8 

Receive SMS and MMS ............................................................................................................................................ 9 

Example ............................................................................................................................................................... 9 

Download mms content .................................................................................................................................... 10 

Error codes ........................................................................................................................................................ 10 

Delete queued messages ...................................................................................................................................... 11 

Error codes ........................................................................................................................................................ 11 

Delivery reports..................................................................................................................................................... 12 

DLR ‐ Post .......................................................................................................................................................... 12 

DLR ‐ Request .................................................................................................................................................... 12 

Error codes ........................................................................................................................................................ 13 

Network query / HLR Lookup ................................................................................................................................ 14 

New query ......................................................................................................................................................... 14 

Error codes ........................................................................................................................................................ 15 

Recieve results .................................................................................................................................................. 15 

Prefix search (Code word) ..................................................................................................................................... 15 

Error codes ........................................................................................................................................................ 16 

2

Create prefix (codeword) ...................................................................................................................................... 16 

Error codes ........................................................................................................................................................ 17 

Create subprefix .................................................................................................................................................... 17 

Error codes ........................................................................................................................................................ 18 

List prefix data ....................................................................................................................................................... 18 

Error codes ........................................................................................................................................................ 19 

Manage prefix rules .............................................................................................................................................. 19 

Error codes ........................................................................................................................................................ 21 

Manage contacts ................................................................................................................................................... 22 

Get updated currency values ................................................................................................................................ 23 

Premium SMS tariff classes ................................................................................................................................... 24 

Norway, short code 2440 .................................................................................................................................. 24 

Code examples ...................................................................................................................................................... 26 

Send SMS........................................................................................................................................................... 26 

ASP – VBScript ............................................................................................................................................... 26 

ASP.NET – C# ................................................................................................................................................. 26 

ASP.NET – VB ................................................................................................................................................. 27 

PHP 4 ............................................................................................................................................................. 27 

PHP 5 ............................................................................................................................................................. 28 

Send MMS ......................................................................................................................................................... 28 

Useful links .................................................................................................................................................... 28 

Receive SMS and MMS ...................................................................................................................................... 29 

ASP – VBSCRIPT ............................................................................................................................................. 29 

PHP ................................................................................................................................................................ 29 

How to store Base64 data as Image type in Microsoft SQL Server ................................................................... 30 

Function: Base64toBin .................................................................................................................................. 30 

Base64 to Binary procedure .......................................................................................................................... 31 

3

SENDEGA API DOCUMENTATION 

API last updated 28.7.2008 

INTRODUCTION 

Neovada Telecom AS and its product Sendega.com is a solution and technology for micro payments and 

communication using SMS, MMS and WAP messaging. Neovada Telecom AS act as a transparent, white‐label 

Content Acquirer and Transaction Router between Operators and Content Providers. Content Providers are 

provided with an easily implemented interface to connect to Sendega.com, which handles integration to the 

Operators. 

This document provides a description of how to integrate the Content Provider’s services for sending and 

receiving SMS, MMS and WAP messages trough the Sendega.com system. The document is intended for 

technical architects and designers of the Content Provider’s services. 

OVERVIEW 

Sendega API consists of a set of methods for sending and receiving SMS, MMS and WAP messages. All 

responses in HTTP are answered with XML. Customer ID (CID) and password must always be used when using 

the methods. 

SECURITY 

All IP addresses for servers that will communicate via the API should be registered with us to prevent 

unauthorised persons sending SMS messages from your account. IP addresses can be registered on our 

customer pages at Sendega.com 

FORMATS AND STANDARDS 

All values are sent/received must be as described in this document. The date format is ISO‐8601. YYYY‐MM‐DD 

HH:MM Return values comply with xml version 1.0 and use ISO‐8859‐1 encoding. All return xml are guaranteed 

“well formed”, and follow the template settings in this API for each individual method. 

Enquiries to Sendega.com system can either be POST or GET. We recommend POST for methods where a long 

message, or many telephone numbers, etc, are sent, as GET has a limitation in the length of the address string. 

All communication takes place via HTTP POST/GET. We support both standard http, and https for encrypted 

connection. 

http://api.sendega.com 

https://api.sendega.com 

4

SEND SMS AND MMS 

Parameter Type Default M/O* Max Description 

value 

length 

CID Integer ‐ M 5 Customer ID for identification 

Password String ‐ M 20 Customer password for identification 

Recipient String ‐ M 8000 The MSISDN that the message should be 

sent to, starting with country code: 

Example 479232592. 

Multiple recipients are comma separated 

GroupID Integer ‐ O 5 GroupID for use of local contact groups 

stored at Sendega.com 

FromNumber Integer If omitted, 

this value is 

O 16 The originating MSISDN or short number 

address for the outgoing message. 

set by 

Sendega. 

FromAlpha String ‐ O 11 The originating alpha numeric address for 

the outgoing message. Behavior may vary 

with Operator integrations 

Header String O 280 Message header. Must be hex‐encoded. 

Only used when sending binary messages. 

Msg‐parameter must contain the message 

content hex‐encoded. 

Msg String ‐ M 640 The message content. The system 

automatically splits the message up into 

more messages if the text length exceeds 

160 characters. Message will automatically 

be displayed as one single long message at 

the receiver, if the receiver’s phone 

supports it. 

MMSData String ‐ O ‐ The MMS file is delivered as Base 64 

encoded string. Example 

MMSData=UESDBBQACAAIAAYS 

Pricegroup Integer 0 O 5 Tariff class for sending premium messaging 

(premium rate). Valid tariff classes is 

documented in own chapter. See note 

below ¹ 

Operator Integer 0 O 4 Must be included when sending premium 

messages. 

See note below ² 

Sendtime String Immediately O 25 The message can be delivered with delayed 

delivery time. 

Format: YYYY‐MM‐DD HH:MM:SS 

Flash Integer 0 O 1 Sends the message directly to the 

recipients display. Behavior may vary with 

Operator integrations and recipients 

equipment. 

ReferenceID String ‐ O 50 Only to be used when sending premium 

SMS to UK and NL³ 

CustomerMsgID Integer ‐ O 19 Your local msgid reference. 

* M = Mandatory, O = Optional 

5

¹ When sending premium messages, the fromNumber parameter must be the short code available for the 

preferred country. Ex fromNumber=2440 for Norway. Please see tariff classes in own chapter for available 

short codes. 

² Operator is only used when sending premium messages. If operator is omitted the system will perform a 

network query. Price 0.10 NOK 

³ ReferenceID is only to be used for subscription services where registration is done on web etc. First premium 

SMS must be “referenceid=26;STARTWEB” for Netherland. and referenceid=27;STARTWEB for UK customers. 

Message is sent to operator, and the user is registered to your service. If message is successful, then all 

messages are to be sent with referenceid=26;WARN for Netherland and referenceID=27;WARN for UK. This 

message will be delivered, and end user is charged. 

EXAMPLES 

EXAMPLE – SEND SMS 

http://api.sendega.com/sendSMS.asp 

?cid=xxx 

&password=xxxx 

&recipient=4796554583 

&fromAlpha=Sendega.com 

&msg=Hello world! 

EXAMPLE – SEND BINARY SMS 


?cid=xxx 




&header=0B05040B84C0020003100301 

&msg=6C497900436F6E746163747300746578742F782D76636172640043616C656E6 [..] 

EXAMPLE – SEND MMS 


?cid=xxx 




&msg=Hello world! 

&mmsdata= /9j/4AAQSkZJRgABAQEASABIAAD/7QAcUGhvd […] 

6

RETURN VALUES 

RETURNVALUES WHEN MESSAGE IS SENT SUCCESSFULLY 

 

 

true 

41541 

 

RETURNVALUE WHEN MESSAGE FAILED. 

 

 

false 

xxxxx 

10xx 

 

ERROR CODES 

Error no 

Error description 

1001 Wrong CID 

1002 Password not specified 

1003 Message not specified 

1004 Recipient or groupid not specified 

1005 Fromalpha value is barred 

1006 Wrong date and time format 

1007 CID and password does not match, or no access 

1008 Message to long 

1009 Server IP: xxx.xxx.xxx.xxx have no access to this account. 

1010 Your demo account is empty. Please contact customer service 

1011 Your account is not upgraded for use of premium SMS. 

1012 Recipient not a valid MSISDN 

1013 GroupID contains non‐numeric characters. Use one groupID only. 

1014 Local referenceID (customerID) must be a numeric value. 

1015 Sendervalue missing. Use fromAlpha or fromNumber parameter. 

1016 Not a valid pricegroup 

1017 FromAlpha value to long. Maximum 11 characters. 

1018 Internal error – Contact customer service 


1020 Correct short code must be specified as fromNumber when sending premium sms 

7

SEND WAP PUSH 

Wap push is sent as an ordinary SMS with clear text. The message to be sent must use the following syntax: 

wappush:wap.vg.no;|;Norwegian newspaper 

EXAMPLE 


?cid=xxx 




&msg= wappush:wap.vg.no;|;Norwegian newspaper 

ERROR CODES 

Error no 




1003 Message not specified 

1004 Recipient or groupid not specified 

1005 Fromalpha value is barred 

1006 Wrong date and time format 


1008 Message to long 


1010 Your demo account is empty. Please contact customer service 

1011 Your account is not upgraded for use of premium SMS. 

1012 Recipient not a valid MSISDN 

1013 GroupID contains non‐numeric characters. Use one groupID only. 

1014 Local referenceID (customerID) must be a numeric value. 

1015 Sendervalue missing. Use fromAlpha or fromNumber parameter. 


1017 FromAlpha value to long. Maximum 11 characters. 



1020 Correct short code must be specified as fromNumber when sending premium sms 

8

RECEIVE SMS AND MMS 

To be able to receive messages you must order a code word (prefix) from Sendega customer pages. It may take 

up to 2 hours from the code word is registered until it can be used. By default, all messages received is only 

stored at Sendega.com. You can add several rules to a code word, like automatic response and forwarding to 

external URL address using HTTP GET method as described here. 

IMPORTANT: 

The URL that receives the message must return the text OK only, if the forward is to be regarded as 

successful. 

Parameter Type Default value M/O* Max length Description 

msgid Integer ‐ M 10 Unique message ID 

tel Integer ‐ M 16 The Consumer’s MSISDN, starting 

with the country code (Sender of the 

text). Example 4795956584. 

msg String ‐ M 640 Message content as sent from 

Consumer. 

If MMS message, this parameter wil 

contain the message subject. 

prefixID Integer M 10 Each codeword has its unique ID at 

Sendega. If subcodeword is used, 

the subcodeword’s id is returned. 

prefix String ‐ M 30 Codeword. 

operator Integer ‐ M 5 The ID of the Consumer’s Mobile 

Operator. A list of available 

operators is provided by Sendega 

upon request. 

shortCode Integer ‐ M 11 The short number the message was 

sent to. Example: 2440 

isMMS Integer 0 M 1 If MMS, value is 1 

mmsFile String ‐ O 500 Name of the zipfile to be 

downloaded from our webserver. 

mmmsData String ‐ O MMSdata as Base64 encoded string. 


EXAMPLE 

EXAMPLE – INCOMING SMS FORWARDING 

http://www.mywebserver.com/sms_in.asp 

?msgid=423423 

&tel=4799xxxxxx 

&msg=PREFIX my message 

&prefixID=xx 

&prefix=PREFIX 

&operator=230 

&shortCode=2440 

9

EXAMPLE ‐ INCOMING MMS FORWARDING 

http://www.mywebserver.com/sms_in.asp 

?msgid=423423 


&msg=PREFIX my message 

&prefixid=xx 

&prefix=PREFIX 

&operator=230 

&shortcode=2440 

&isMMS=1 

&mmsFile=mms2008/1302_423421.zip 

&mmsData= /9j/4AAQSkZJRgABAQEASABIAAD/7QAcUGhvd […] 

* Please see customer pages and url‐forward settings for your prefix to receive mmsdata. 

DOWNLOAD MMS CONTENT 

MMS files are stored on our API server for easy download. Use this method to download the zip‐file 



Password String ‐ M 20 Customer password for 

identification 

mmsFile String ‐ M 50 Name of the zipfile to download. 

EXAMPLE 

http://www.mywebserver.com/getmms.asp 

?cid=xxxx 

&passwordl=xxxxxx 

&mmsfile=mms_2008\1302_423421.zip 

ERROR CODES 

Error no 




9003 MMS file not specified 


9005 File not found or does not exists 


10

DELETE QUEUED MESSAGES 

Messages sent using the sendtime parameter is queued on our servers and sent to enduser at given time. 

These messages can be deleted using this method. 





msgid Integer ‐ M 10 MessageID 

EXAMPLE 

http://api.sendega.com/deleteQuedSMS.asp 

?cid=xxxx 

&password=xxxxxx 

&msgid=18254541 

ERROR CODES 

Error no 





10004 Msgid not specified 

10005 No queued message found 


11

DELIVERY REPORTS 

All messages are delivered with status codes from the various telecom operators. Delivery reports can be either posted 

automatically to an external URL, or requested. 

DLR ‐ POST 

The following parameters will be POSTED to an external URL. This URL must be added on our customer pages. 


msgid Integer ‐ M 5 Unique messageid 

recipient Integer M 16 Recipients MSISDN 

statusid Integer M 2 4=Delivered, 5=Not delivered 

registered String M 25 When message was registered at 

Sendega.com Format: YYYY‐MM‐DD 

HH:MM:SS.MII 

sentdate String M 25 When message was sent to operator 

Format: YYYY‐MM‐DD 

HH:MM:SS.MII 

statusUpdated String M 25 When message was updated with 

DLR from operator. Format: YYYY‐ 

MM‐DD HH:MM:SS.MII 

revenue String M 10 Payout or cost value in NOK 

errorcode String M 250 Short errorcode from operator 

errordescription String M 1000 Long errodescription if error. 

mcc Integer M 5 

Mobile country code. 

mnc Integer M 5 

Mobile network code. (Operator) 

network String M 50 Mobile network name 

countrycode String M 5 Countrycode. Ex. Norway=47 

customermsgid Integer M 


All mcc and mnc codes are available as CSV documents at http://www.sendega.com 

DLR ‐ REQUEST 





Msgid String ‐ M ‐ The unique Sendega msgid returned 

when sending message. Multiple 

msgid’s must be comma separated. 

Reporttype String XML O 3 Delivery reports can be returned as 

CSV or XML. 


12

EXAMPLE 

http://api.sendega.com/getSmsStatus.asp 

?cid=xxx 


&msgid=9023027 

&reporttype=xml 

RETURN VALUE 

Return value when using report type=xml 

 

 

true 

1 

 

9023027 

0 

479xxxxxxx 

4 

0 

 

DELIVERED 

 

2008-05-11 12:32 

0 

 

2440 

2008-05-11 12:33 

1 

Norway 

-0,39 

 

 

ERROR CODES 

Error no 




6003 Msgid not specified 

6004 CID and password does not match or no access 


6006 No SMS found 



STATUS CODES 

Error no 


1 Message received OK to Sendega db 

2 Processing message 

3 Delivered operator. Waiting for delivery report. 

4 Message delivered to end user 

5 Message failed. See errordescription field for more details 

13

8 Temporary queued. 

13 Queued for HLR 

14 Processing HLR query 

15 Waiting for HLR report 

NETWORK QUERY / HLR LOOKUP 

HLR lookup is used to check which country and operator the mobile phone number belongs to, as well as which 

country the mobile subscriber is located in. You post a new query and receive a hlr‐id to track the query. 

Results are posted back to an URL located on your server. This URL must be specified on our customer pages at 

http://www.sendega.com 

NEW QUERY 





Msisdn Integer ‐ M 16 The Consumer’s MSISDN. 

postBackURL String ‐ O 1000 Postback URL to post query results. 


EXAMPLE 

http://api.sendega.com/hlr.asp 

?cid=xxx 


&msisdn=4479xxxxxx 

&postbackurl=http://www.mydomain.com/hrlResults.asp 

RETURNVALUES WHEN MESSAGE IS SENT SUCCESSFULLY 

 

 

true 

41541 

 

RETURNVALUE WHEN MESSAGE FAILED. 

 

 

false 

xxxxx 

70xx 

 

14

ERROR CODES 

Error no 




7003 Not a valid msisdn 


7005 Server IP: xxxx have no access to this account. 

7006 Your account is not upgraded for use of HLR 

7007 PostbackURL not specified, or no URL saved in your account. 

RECIEVE RESULTS 

The following parameters will be POSTED to an external URL. This URL must be added on our customer pages or provided 

using the postbackurl parameter. 


Msgid Integer ‐ M 9 Unique queryid 

Msisdn Integer ‐ M 16 Msisdn 

Mcc Integer ‐ M 3 Mobile country code 

Mnc Integer ‐ M 3 Mobile network code 

Network String ‐ M 500 Network name 

formerNetworkName String ‐ M 500 Former network name 

Country String ‐ M 500 Country 


ALL 

PREFIX SEARCH (CODE WORD) 

To receive messages a code word must be ordered at Sendega customer pages. This method allows you to do a 

search for available code words at Sendega’s short codes. Available short codes can be found on Sendega 

customer pages. 





Prefix String ‐ M 30 Code word or prefix to search for. 

Shortcode Integer ‐ M 16 Short code. Example 2440 


EXAMPLE 

http://api.sendega.com/checkPrefix.asp 

?cid=xxx 


&prefix=MYPREFIX 


15

RETURN VALUE 

Return value when code word is available. 

 

 

true 

 

Return value when code word is taken. 

 

 

false 

Prefix not available 

2009 

 

ERROR CODES 

Error no 




2003 Prefix not specified 

2004 Prefix must be between 3 and 12 characters 

2005 Short code not specified 



2008 Not a valid short code 

2009 Prefix not available 

CREATE PREFIX (CODEWORD) 

Use this method to create new codeword. When created, each codeword is reserved for one year. Please see 

our webpage for current codeword prices. 





Prefix String ‐ M 30 Prefix to create. 

Shortcode Integer ‐ M 16 Short code. Example 2440 


EXAMPLE 

http://api.sendega.com/createPrefix.asp 

?cid=xxx 


&prefix=MYPREFIX 


RETURN VALUE 

Return value when code word is available. 

16

 

true 

 

Return value when code word is taken. 

 

 

false 

3007 

Prefix not available 

 

ERROR CODES 

Error no 




3003 Prefix not specified 

3004 Prefix must be between 3 and 12 characters 

3005 Short code not specified 


3007 Prefix not available 


3009 Demo accounts not allowed to create prefix 

3010 Not a valid short code 

3011 Not able to create prefix 

CREATE SUBPREFIX 

Use this method to create new subprefixes. 





PrefixID Integer ‐ M 5 PrefixID 

Subprefix String M 20 Name of the new subprefix 


EXAMPLE 

http://api.sendega.com/createSubPrefix.asp 

?cid=xxx 


&prefixID=950 

&subprefix=NewSubprefix 

RETURN VALUE 

17

Return value when subprefix is created. 

 

 

true 

 

Return values when failed. 

 

 

false 

13002 

Password not specified 

 

ERROR CODES 

Error no 




13003 PrefixID not specified or not correct. 

13004 Subprefix not specified 



13007 Demo accounts not allowed to update subprefixdata 

13008 Internal error 

LIST PREFIX DATA 





PrefixID Integer ‐ O 5 Unique prefixid. When left out, 

prefixdata for all prefixes will be 

listed. 

EXAMPLE 

http://api.sendega.com/getPrefixData.asp 

?cid=xxx 


RETURN WHEN OK 

 

true 

 

131 

18

false 

DEMO 

2440 

True 

Hi. This is your reciept! 

0 

Sendega 

False 

False 

http://www.mydomain.com/recieveIncomingMsg.asp 

False 

False 

 

False 

 

False 

 

False 

False 

 

False 

 

 

RETURN WHEN FAILED 

 

 

false 

11001 

Wrong CID 

 

ERROR CODES 

Error no 






11005 Internal error 

MANAGE PREFIX RULES 

Each prefix can have a set of rules handling the incoming messages. 





PrefixID Integer ‐ M 5 Prefix ID for prefix to update. 

ReplyMsgActivated Bit ‐ O 1 0=Disabled, 1=Enabled 

ReplyMsg String ‐ M 160 Message sent back to sender 

ReplyPrice Integer 0 OIE 5 Tariff class for sending premium 

messaging (premium rate). Valid 

tariff classes is documented in own 

19

chapter 

ReplySender String ‐ OIE 16 Can be either a valid msisdn (max 

length=16) or alphanumeric (max 

length=11). 

ReplyFlash Bit 0 OIE 1 Sends the message directly to the 

recipients display. Behavior may 

vary with Operator integrations and 

recipients equipment. 

FwUrlActivated Bit ‐ O 1 0=Disabled, 1=Enabled 

FwUrl String ‐ OIE 1000 Full URL (http://yourdomain.com/) 

FwUrlBase64 Bit ‐ OIE 1 If enabled, the mmsdata will be 

posted as base64 encoded string. 

FwEmailActivated Bit ‐ O 1 0=Disabled, 1=Enabled 

FwEmail String ‐ OIE Valid email address. 

FwMobileActivated Bit ‐ O 1 0=Disabled, 1=Enabled 

FwMobile Integer ‐ OIE 16 Valid MSISDN. 

FwGroupActivated Bit ‐ O 1 0=Disabled, 1=Enabled 

FwGroupSender String ‐ OIE 16 Can be either a valid msisdn (max 

length=16) or alphanumeric (max 

length=11). 

FwGroupPrice Integer 0 OIE 5 Tariff class for sending premium 

messaging (premium rate). Valid 

tariff classes is documented in own 

chapter 

FwGroupID Integer ‐ OIE 5 Valid goupID to forward incoming 

message. 

AddToContacts Bit ‐ O 1 Add sender to contactlist 

AddToGroup Bit ‐ O 1 0=Disabled, 1=Enabled 

AddToGroupID Integer ‐ OIE 5 Valid groupID 

RemoveFromGroup Bit ‐ O 1 0=Disabled, 1=Enabled 

* M = Mandatory, O = Optional, OIE = Only if rule enabled 

EXAMPLE – ACTIVATE FORWARDING TO URL 

http://api.sendega.com/updatePrefixRules.asp 

?cid=xxx 


&fwUrlActivated=1 

&fwUrl=http://www.mywebserver.com/incoming.asp 

&fwUrlBase64=0 

EXAMPLE – ACTIVATE AUTOMATIC RESPONSE 


?cid=xxx 


&replyMsgActivated=1 

&replyMsg=Thank you for your order. 

&replyPrice=5000 

&replySender=2440 

&replyFlash=0 

20

EXAMPLE – ACTIVATE AUTOMATIC RESPONSE AND ADD TO CONTACT LIST 


?cid=xxx 


&replyMsgActivated=1 

&replyMsg=Thank you for your order. 

&replyPrice=5000 

&replySender=2440 

&replyFlash=0 

&addToContacts=1 

RETURN VALUES 

Return value when rules are updated successfully. 

 

 

true 

 

Returnvalues when failed. 

 

 

false 

12010 

URL must be specified 

 

ERROR CODES 

Error no 




12003 PrefixID not specified, or not correct. 

12004 CID and password does not math or no access. 


12006 Demo accounts not allowed to update prefixrules 

12007 Not rules were set to be updated 

12008 Replymsg not specified 

12009 Reply sender not specified 

12010 URL must be specified 

12011 Email not specified or invalid 

12012 Not a valid msisdn 

12013 Not a valid groupid 

12014 Groupid not specified 


21

MANAGE CONTACTS 

As customer you have access to send messages directly from our customer pages. This method give you access 

to manage your contacts. 





Countrycode Integer ‐ M 5 Country code. Norway 47 

Tel Integer ‐ M 16 Mobile number (msisdn) 

Firstname String ‐ O 50 Users firstname 

Lastname String ‐ O 100 Users lastname 

Delete Bit ‐ O 1 Add this parameter to delete contact 

Lookup Bit ‐ O 1 Not implemented. 

Will be used to retrieve msisdn 

owner information like firstname 

etc. 


EXAMPLE 

http://api.sendega.com/updateContact.asp 

?cid=xxx 


&countrycode=47 


&firstname=John 

&lastname=Doe 

RETURN VALUE 

Return value when code word is available. When a new contact is added to your contact list, the parameter 

newcontact=1. If the given mobile number already exists the system performs an update and the paramtere 

newcontact=0. 

 

 

true 

1 

 

The following return value is given when a contact is deleted. 

 

 

true 

1 

 

22

GET UPDATED CURRENCY VALUES 

Our system is updated three times each day with current currency rates. Rates are provided from DNB Nor ASA 






EXAMPLE 

http://api.sendega.com/getCurrency.asp 

?cid=xxx 


RETURN VALUE 

 

 

true 

16.10.2007 15:10:00 

 

Norway

PREMIUM SMS TARIFF CLASSES 

We provide SMS billing (premium SMS) to several countries. Please upgrade your Sendega account to use 

premium SMS for the preferred short code and country. Please see Sendega.com for an updated out payment 

list. 

NORWAY, SHORT CODE 2440 

End user price is in NOK 

Price group, tariff 

End user price (inc vat) 

100 1,00 kr 

200 2,00 kr 

300 3,00 kr 

400 4,00 kr 

500 5,00 kr 

600 6,00 kr 

700 7,00 kr 

800 8,00 kr 

900 9,00 kr 

1000 10,00 kr 

1100 11,00 kr 

1200 12,00 kr 

1300 13,00 kr 

1400 14,00 kr 

1500 15,00 kr 

1600 16,00 kr 

1700 17,00 kr 

1800 18,00 kr 

1900 19,00 kr 

2000 20,00 kr 

2100 21,00 kr 

2200 22,00 kr 

2300 23,00 kr 

2400 24,00 kr 

2500 25,00 kr 

2600 26,00 kr 

2700 27,00 kr 

2800 28,00 kr 

2900 29,00 kr 

3000 30,00 kr 

3500 35,00 kr 

3900 39,00 kr 

4000 40,00 kr 

4500 45,00 kr 

4900 49,00 kr 

5000 50,00 kr 

5500 55,00 kr 

5900 59,00 kr 

6000 60,00 kr 

6500 65,00 kr 

6900 69,00 kr 

24

7000 70,00 kr 

7500 75,00 kr 

7900 79,00 kr 

8000 80,00 kr 

8500 85,00 kr 

8900 89,00 kr 

9000 90,00 kr 

9500 95,00 kr 

9900 99,00 kr 

10000 100,00 kr 

25

CODE EXAMPLES 

SEND SMS 

ASP – VBSCRIPT 

Download sendega_sms_library.asp: http://www.sendega.com/documents/sendega_sms_asp_library.txt 

 

 

 

ASP.NET – C# 

Download smsClass.cs: http://www.sendega.com/documents/sendega_sms_cnet_library.txt 

private void SmsFunc() 

{ 

string sender = "Sendega"; 

string recipient = "4799xxxxxx"; 

string message = "My testmessage"; 

int priceGroup = 0; 

int flash = 0; 

} 

SmsClass smsClass = new SmsClass(); 

string res = smsClass.sendSms(sender, recipient, message, priceGroup, flash); 

int resint; 

if (int.TryParse(res, out resint)) 

{ 

Response.Write("SMS sent successfully (" + res + ")"); 

} 

else 

{ 

Response.Write("SMS failed. Error description: " + res); 

} 

26

ASP.NET – VB 

Download smsClass.vb: http://www.sendega.com/documents/sendega_sms_vbnet_library.txt 

Private Sub SmsFunc() 

Dim sender As String = "Sendega" 

Dim recipient As String = "4799xxxxxx" 

Dim message As String = "My testmessage" 

Dim priceGroup As Integer = 0 

Dim flash As Integer = 0 

Dim smsClass As New SmsClass() 

Dim res As String = smsClass.sendSms(sender, recipient, message, priceGroup, 

flash) 

Dim resint As Integer 

If Int32.TryParse(res, resint) Then 

Response.Write("Sms sent successfully. (" & res & ")") 

Else 

Response.Write("Sms failed. Error description: " & res) 

End If 

End Sub 

PHP 4 

Download Sendega_sms_php_4_library.php: 

http://www.sendega.com/documents/sendega_sms_php_4_library.txt 

 

 

Send sms 

 

 

PHP 5 

Download Sendega_sms_php_5_library.php: 

http://www.sendega.com/documents/sendega_sms_php_5_library.txt 

 

 

Send sms 

 

 

RECEIVE SMS AND MMS 

ASP – VBSCRIPT 

 

 

PHP 

 

29

HOW TO STORE BASE64 DATA AS IMAGE TYPE IN MICROSOFT SQL SERVER 

FUNCTION: BASE64TOBIN 

Add this function to your MS SQL database 

CREATE FUNCTION base64toBin (@bin64raw varchar(8000)) 

RETURNS varbinary(8000) 

AS 

BEGIN 

DECLARE @out varbinary(6000) 

DECLARE @i int 

DECLARE @length int 

DECLARE @bin64char char(1) 

DECLARE @bin64rawval tinyint 

DECLARE @bin64phase tinyint 

DECLARE @bin64nibble1 tinyint 



SELECT @bin64phase = 0 

SELECT @i = 1 

SELECT @length = len(@bin64raw) 

IF right(@bin64raw, 1) '='SET @length = @length + 1 

WHILE @i < @length 

BEGIN 

SELECT @bin64char = substring(@bin64raw,@i,1) 

BEGIN 

IF ASCII(@bin64char) BETWEEN 65 AND 90 

SELECT @bin64rawval = ASCII(@bin64char)-65 

ELSE 

IF @bin64char LIKE '[a-z]' 

SELECT @bin64rawval = ASCII(@bin64char)-71 

ELSE 

IF @bin64char LIKE '[0-9]' 

SELECT @bin64rawval = ASCII(@bin64char)+4 

ELSE 

IF @bin64char = '+' 


ELSE 

IF @bin64char = '/' 


ELSE 

BEGIN 

SELECT @bin64rawval = 0 

SELECT @i = @length-1 

END 

END 

IF @bin64phase = 0 

BEGIN 

SELECT @bin64nibble1 = (@bin64rawval - @bin64rawval%4)/4 

SELECT @bin64nibble2 = @bin64rawval%4 

SELECT @bin64nibble3 = 0 

END 

ELSE 

IF @bin64phase =1 

BEGIN 

SELECT @bin64nibble2 = (@bin64nibble2*4) + (@bin64rawval - @bin64rawval%16)/16 


IF @i

SELECT @out= @out + convert (binary(1),((16*@bin64nibble1) + @bin64nibble2)) 

END 

ELSE 


BEGIN 

SELECT @bin64nibble1 = @bin64nibble3 

SELECT @bin64nibble2 = (@bin64rawval - @bin64rawval%4)/4 


SELECT @out=@out+ convert (binary(1),((16*@bin64nibble1) + @bin64nibble2)) 

END 

ELSE 


BEGIN 

SELECT @bin64nibble1 = (@bin64nibble3*4) + (@bin64rawval - @bin64rawval%16)/16 


SELECT @out=@out+ convert (binary(1),((16*@bin64nibble1) + @bin64nibble2)) 

END 

SELECT @bin64phase = (@bin64phase + 1)%4 

SELECT @i = @i + 1 

END 

RETURN(@out) 

END 

BASE64 TO BINARY PROCEDURE 

This procedure shows how to store base64 data as image type using the base64toBin function. 

CREATE PROCEDURE receiveMMS 

@msgid int, 

@mmsData text 

AS 

/*** Table schema used for test 

CREATE TABLE testData(msgid int, mmsData image, CONSTRAINT PK_testData primary key 

nonclustered (msgid)) 

***/ 

-- insert NULL (0x0) into the image field so that the TEXTPTR function will work 

INSERT testData(msgid, mmsData) VALUES (@msgid, 0x0) 

DECLARE @pointer varbinary(16) 

SELECT @pointer = TEXTPTR(mmsData) FROM testData WHERE msgid = @msgid 

DECLARE @buff varchar(2400) 

DECLARE @offset int, @imgOffset int 

SET @offset = 1 

SET @imgOffset = 0 

WHILE @offset

Sendega API documentation.pdf - GetACoder

Create successful ePaper yourself

Delete template?

Save as template?