minchao / go-mitake

A Mitake SMS library for Golang

go-mitake

go-mitake is a Go client library for accessing the Mitake SMS API (Taiwan mobile phone number only).

Installation

go get -u github.com/minchao/go-mitake

Usage

import "github.com/minchao/go-mitake"

Construct a new Mitake SMS client, then use to access the Mitake API. For example:

client := mitake.NewClient("USERNAME", "PASSWORD", nil)

// Retrieving your account balance
balance, err := client.QueryAccountPoint()

Send an SMS:

message := mitake.Message{
    Dstaddr: "0987654321",
    Smbody:  "Message ...",
}

response, err := client.Send(message)

Send multiple SMS:

messages := []mitake.Message{
    {
        Dstaddr: "0987654321",
        Smbody:  "Message ...",
    },
    // ...
}

response, err := client.SendBatch(messages)

Send an long SMS:

message := mitake.Message{
    Dstaddr: "0987654321",
    Smbody:  "Long message ...",
}

response, err := client.SendLongMessage(message)

Query the status of messages:

response, err := client.QueryMessageStatus([]string{"MESSAGE_ID1", "MESSAGE_ID2"})

Use webhook to receive the delivery receipts of the messages:

http.HandleFunc("/callback", func(w http.ResponseWriter, r *http.Request) {
    receipt, err := mitake.ParseMessageReceipt(r)
    if err != nil {
        // Handle error...
        return
    }
    // Process message receipt...
})
// The callback URL port number must be standard 80 (HTTP) or 443 (HTTPS).
if err := http.ListenAndServe(":80", nil); err != nil {
    log.Printf("ListenAndServe error: %v", err)
}

License

See the LICENSE file for license rights and limitations (MIT).

go-mitake's Issues

ClientID 不是純英數會造成 panic 及更新 API 到文件 v2.08 版

panic: runtime error: invalid memory address or nil pointer dereference
[signal 0xc0000005 code=0x0 addr=0x0 pc=0x8eca9b]

goroutine 1 [running]:
github.com/minchao/go-mitake.parseMessageResponseByPattern(0xa09022, 0x12, 0x279f0240, 0xc000519760, 0x0, 0x0, 0x0)
	d:/tmp/riverland-sms-backend/src/vendor/github.com/minchao/go-mitake/message.go:173 +0x42b
github.com/minchao/go-mitake.parseLongMessageResponse(0x279f0240, 0xc000519760, 0x0, 0x0, 0x0)
	d:/tmp/riverland-sms-backend/src/vendor/github.com/minchao/go-mitake/message.go:193 +0x80
github.com/minchao/go-mitake.(*Client).SendLongMessageBatch(0xc000154050, 0xc000435b80, 0x1, 0x1, 0x0, 0x0, 0x0)
	d:/tmp/riverland-sms-backend/src/vendor/github.com/minchao/go-mitake/api.go:55 +0x591
github.com/minchao/go-mitake.(*Client).SendLongMessage(0xc000154050, 0x0, 0x0, 0xc000422422, 0xa, 0x0, 0x0, 0xc0000b0000, 0x1bb, 0xc000422438, ...)
	d:/tmp/riverland-sms-backend/src/vendor/github.com/minchao/go-mitake/api.go:65 +0x101
main.main()
	d:/tmp/riverland-sms-backend/src/main.go:90 +0x5ef
Process exiting with code: 0