Jimmmmy SMS Server

Sending SMS by integrate MessageBird service.

Requirements

Golang 1.10 up.
Sign up for a free MessageBird account.
Top-up amount of credit you'd like to add to your balance.
Create a new access key in the developers sections, then add key to the config file.

Just doing this

$ go get github.com/tvpsh2020/messagebird-server

Just doing this

$ cp config.json.default config.json

then you will be able to start testing this service with test API key.

POST /api/message

body payload

Parameter	Type	Description
originator	string	Sender identity, this can be a telephone number (including country code) or an alphanumeric string. In case of an alphanumeric string, the maximum length is 11 characters.
body	string	The body of the SMS message, should not be empty.
recipients	string	Receivers, multiple receiver should be split with comma, any words other than number will be filter out.

body payload example

{
    "originator": "12345678901",
    "body": "Hello",
    "recipients": "886987654321, +886987654321"
}

correct response example, status code = 201

{
    "result": "success",
    "data": {
        "message": "your message will be send if no bad things happen, please check server log"
    }
}

error response example, status code = 400

{
    "result": "fail",
    "data": {
        "message": "message content cannot be empty"
    }
}

GET /api/balance

correct response example, status code = 200

{
    "result": "success",
    "data": {
        "Payment": "prepaid",
        "Type": "euros",
        "Amount": 2.09
    }
}

error response example, status code = 400

{
    "result": "fail",
    "data": {
        "message": "The MessageBird API returned an error"
    }
}

$ go test ./...

If message content/body is longer than 160 chars with plain format (70 with unicode format), split it into multiple parts. The rule of split mechanism is define in here.
Do not send empty or incorrect parameter values to MessageBird.
Throughput of MessageBird API is one API request per second, no matter what jobs you are doing
Sending SMS with UDH (User Data Header) can make MessageBird Server know that your SMS should be concatenated.
In theory the concatenated SMS may consist of up to 255 separate SMS messages, but in MessageBird, the concatenated SMS is maximum separated to 9 parts, if your SMS over the rule, the whole messages will be buffered on MessageBird Server and THIS WILL BE CHARGED WITHOUT SENDING SUCCESSFUL except you set the validity time.
Euro sign is not a Plain text for MessageBird, should be send with Unicode to display.
Curly Quotation Marks in Plain text mode will be translate, should be send with Unicode to display.

‘’ -> '
“” -> "

Can only send hex string with plain text, if you send with unicode, it will be fail.
Can only send concatenated SMS with plain text correctly, Unicode will fail to concatenated.