Locations
This interface can be reached at three different URLs which are connected to the Internet via different ISPs.
We recommend that you implement your program to use the HTTPS X automatically since this is load balanced to the other to URLs and will rout your requests to one of the locations even if the other is down for maintenance.
Protocol | URL |
HTTPS 1 | |
HTTPS 2 | |
HTTPS X |
How to send SMS
Parameters
Perform a POST to any URL in chapter 4 with the following parameters:
Parameter | Data type | Description |
ServiceId | Integer | This is the serviceId which is used for authentication. This is provided by Support. |
Username | String | This is the username which is used for authentication. This is provided by Support. |
Password | String | This is the password which is used for authentication. This is provided by Support. |
Source | String | This is the source number from where the message should be sent. Usage allows full international numbers (+46732594084), short numbers (72401) or text (Sergel). |
Destination | String | This is the destination number. |
Userdata | String | This is the message itself. GSM default alphabet encoded messages has no maximum length. Note that Extended GSM characters need 2 bytes for one character.
|
UserdataHeader | String | This value may be specified when sending concatenated SMS. More information about valid UDH for long SMS may be given by support upon request. |
ReferenceId | String | For premium SMS. Use id of incoming SMS here. |
Tariff | String | For premium SMS. To charge 10 SEK use tariff SEK1000. Set to null or SEK0 for bulk messages. |
Vat | Double | Vat for premium SMS. 0.0 means no Vat, 25.0 a Vat of 25%. |
ChargeOnly | String | Set to true for a silent charging without any SMS sent, otherwise false. |
Async | String | True for asynchronous call, initial status will be Queued (1005) for a successful call. |
Returns
Response will contain a message with a result code, result description and a message id if successful separated with “;”, i.e. resultCode;resultDescription;messageId.
Name | Data type | Description |
resultCode | Integer | The result code. See Result Codes for more information. |
resultDescription | String | This is the textual description for the result code. |
messageId | String | This is the unique messageId that will appear in the delivery report and should be referred to when sending questions to support. |
Result codes
These are the result codes that may appear in resultCode.
Code | Description | Recommended action | |
0 | Unknown error | Retry, if multiple failures occur contact content-support@sergel.com | |
1 | Temporary routing error | Retry | |
2 | Permanent routing error |
| |
3 | Maximum throttling exceeded | Retry | |
100 | Service not found | Contact content-support@sergel.com for login credentials | |
101 | User not found | Contact content-support@sergel.com for login credentials | |
102 | Account not found | Contact content-support@sergel.com for login credentials | |
103 | Invalid password | Contact content-support@sergel.com for login credentials | |
1000 | Sent | Ok submission of SMS to operator. MessageId will now be present in answer. | |
1001 | Delivered |
| |
1002 | Expired |
| |
1003 | Deleted |
| |
1004 | Mobile full |
| |
1005 | Queued | For asynchronous calls, MessageId will be present in answer. | |
1006 | Not delivered |
| |
2000 | Invalid source number |
| |
2001 | Short number is not supported as source |
| |
2002 | Alpha is not supported as source |
| |
2003 | MSISDN is not supported as source number |
| |
2100 | Short number is not supported as destination |
| |
2101 | Alpha is not supported as destination |
| |
2102 | MSISDN is not supported as destination |
| |
2103 | Operation blocked |
| |
2104 | Unknown subscriber |
| |
2105 | Destination blocked |
| |
2106 | Number error |
| |
2200 | Charging error |
| |
2201 | Subscriber has low balance |
| |
3000 | GSM encoding is not supported |
| |
3001 | UCS2 encoding is not supported |
| |
4000 | Delivery report is not supported |
| |
4001 | Invalid message content |
| |
4002 | Invalid tariff |
| |
4003 | Invalid user data |
| |
4004 | Invalid user data header |
| |
4005 | Invalid data coding |
| |
4006 | Invalid VAT |
| |
4007 | Unsupported content for destination |
| |
Default Alphabet
The default GSM alphabet is the alphabet that will be used when specifying DCS 0 (default DCS).
The following characters will use 1 byte per character.
Unicode (hex) | Character |
0040 | @ |
00a3 | £ |
0024 | $ |
00a5 | ¥ |
00e8 | è |
00e9 | é |
00f9 | ù |
00ec | ì |
00f2 | ò |
00c7 | Ç |
000a | <LINE FEED> |
00d8 | Ø |
00f8 | ø |
000d | <CARRIAGE RETURN> |
00c5 | Å |
00e5 | å |
0394 | Δ |
005f | _ |
03a6 | Φ |
0393 | Γ |
039b | Λ |
03a9 | Ω |
03a0 | Π |
03a8 | Ψ |
03a3 | Σ |
0398 | Θ |
039e | Ξ |
00c6 | Æ |
00e6 | æ |
00df | ß |
00c9 | É |
0020 | <SPACE> |
0021 | ! |
0022 | " |
0023 | # |
00a4 | ¤ |
0025 | % |
0026 | & |
0027 | ' |
0028 | ( |
0029 | ) |
002a | * |
002b | + |
002c | , |
002d | - |
002e | . |
002f | / |
0030 | 0 |
0031 | 1 |
0032 | 2 |
0033 | 3 |
0034 | 4 |
0035 | 5 |
0036 | 6 |
0037 | 7 |
0038 | 8 |
0039 | 9 |
003a | : |
003b | ; |
003c | < |
003d | = |
003e | > |
003f | ? |
00a1 | ¡ |
0041 | A |
0042 | B |
0043 | C |
0044 | D |
0045 | E |
0046 | F |
0047 | G |
0048 | H |
0049 | I |
004a | J |
004b | K |
004c | L |
004d | M |
004e | N |
004f | O |
0050 | P |
0051 | Q |
0052 | R |
0053 | S |
0054 | T |
0055 | U |
0056 | V |
0057 | W |
0058 | X |
0059 | Y |
005a | Z |
00c4 | Ä |
00c5 | Å |
00d6 | Ö |
00d1 | Ñ |
00dc | Ü |
00a7 | § |
00bf | ¿ |
0061 | a |
0062 | b |
0063 | c |
0064 | d |
0065 | e |
0066 | f |
0067 | g |
0068 | h |
0069 | i |
006a | j |
006b | k |
006c | l |
006d | m |
006e | n |
006f | o |
0070 | p |
0071 | q |
0072 | r |
0073 | s |
0074 | t |
0075 | u |
0076 | v |
0077 | w |
0078 | x |
0079 | y |
007a | z |
00e4 | ä |
00e5 | å |
00f6 | ö |
00f1 | ñ |
00fc | ü |
00e0 | à |
Extended GSM Characters
Unicode (hex) | Character |
000c | <FORM FEED> |
005e | ^ |
007b | { |
007d | } |
005c | \ |
005b | [ |
007e | ~ |
005d | ] |
007c | | |
20ac | € |