SMS Single Send

Send a outbound text message.

URL

Request Method

  • POST

Request Header

  • content-type: application/json
  • X-API-Key: apiKey

Request Examples

curl --request POST \
     --url http://sgapi.yoni-tech.com/v1/sms/send/single \
     --header 'content-type: application/json' \
     --header 'X-API-Key: Hs42eBZ6vuTR7oBSs3zq7HscgiAr6Y252Y5BbzrbKoI=' \
     --data '
{
  "senderId": "Brand",
  "mobile": "62xxxxxxxxxx",
  "msg": "Your verification code is 1234."
}
'
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"senderId\":\"Brand\",\"mobile\":\"62xxxxxxxxxx\",\"msg\":\"Your verification code is 1234.\"}");
Request request = new Request.Builder()
  .url("http://sgapi.yoni-tech.com/v1/sms/send/single")
  .post(body)
  .addHeader("content-type", "application/json")
  .addHeader("X-API-Key", "Hs42eBZ6vuTR7oBSs3zq7HscgiAr6Y252Y5BbzrbKoI=")
  .build();

Response response = client.newCall(request).execute();

Request Parameter

NameOptionalTypeDescription
mobilenoStringto phone numebr (country code + number,e.g.,62xxxxxxxxx)
msgnoStringcontent, must urlencode(UTF-8) max length 3000
senderIdyesStringsender

Response Example

{
  "code": "0",
  "message": "success",
  "data": {
    "messageId": "2023020417303301200000000204"
  }
}

Response Result

NameTypeDescription
codeStringYONI-TECH's respense code (error codes)
messageStringdescribe the result
dataObjectobj contain messageId
data.messageIdStringunique identifier for this text message