Sendega API documentation.pdf - GetACoder

More documents

Recommendations

Info

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
Page 1 and 2: FRA 1
Page 3: Create prefix (codeword) ..........
Page 7 and 8: RETURN VALUES RETURNVALUES WHEN MES
Page 9 and 10: RECEIVE SMS AND MMS To be able to r
Page 11 and 12: DELETE QUEUED MESSAGES Messages sen
Page 13 and 14: EXAMPLE http://api.sendega.com/getS
Page 15 and 16: ERROR CODES Error no Error descript
Page 17 and 18: true Return value when code word
Page 19 and 20: false DEMO 2440 True Hi. This is yo
Page 21 and 22: EXAMPLE - ACTIVATE AUTOMATIC RESPON
Page 23 and 24: GET UPDATED CURRENCY VALUES Our sys
Page 25 and 26: 7000 70,00 kr 7500 75,00 kr 7900 79
Page 27 and 28: ASP.NET - VB Download smsClass.vb:
Page 29 and 30: RECEIVE SMS AND MMS ASP - VBSCRIPT
Page 31: SELECT @out= @out + convert (binary

Sendega API documentation.pdf - GetACoder

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?