SMS Premium V2

Getting Started

OCA SMS OTP Gateway provide solution to send message otp. In order to hit the OCA SMS OTP Gateway, we provide Endpoint url, so client can hit and use the API.

URL ENDPOINT :

https://webapigw.ocatelkom.co.id

Before you start

You will need :

• OCA API Dashboard account username and password

Response Code

HTTP Status Code

The OCA SMS API Gateway attempts to return the appropriate HTTP Status Codes for every request

Code	Text	Description
200	OK	Success
401	Unauthorized	Missing or Incorrect authentication details
404	Not Found	There is no data available, like user setting etc
406	Not Acceptable	Response when there is invalid format in request
429	To Many Request	Returned when a request cannot be served due to the system's rate limit having been exhausted for the resource
500	Internal Server Error	Something is broken. This is usually a temporary error in server

Error Messages

OCA SMS OTP error messages are returned in JSON Format. Each HTTP Status Code will be accompanied by descriptive error text and code. For example, an error might occur.

{"errors": [{"message": "Invalid Authentication Credentials", "code": 17}]}

Error Codes

This error codes is additional information to explain what happened when some errors occured. The following table describe the code which may appear when working with OCA SMS OTP Gateway. If an error is not listed in the table, going back to HTTP status codes above in order to determine the best way to address the issues.

Code	Text	Description
5	low-balance	Indicationg that your account has no enough balance left
9	Too Many Request Code	Due to the api rate limit, you have to wait until the currently window wxpires, the default api rate limit is in 25 request per seconds. You can check http headers reaponse in order to know the remaining limit of your request. - X-RateLimit-limit : the rate limit of endpoint - X-RateLmit-Remaining : the number of request left - X-RateLimit-Reset : the remaining window before the rate limit resets
13	Internal Error	Corresponds with HTTP 500. An unknown internal error occured
19	Missing Authorization Header	Corresponds with HTTP 401. It indicates Authorization header is not set properly
33	Data doesn't exist	Corresponds with HTTP 404. The certain data is not found
39	[object]	Corresponds with HTTP 406. There are incorrects or missing parameter in request body, it is like the message_value is not same as the template message
43	Auth token is not supplied	Corresponds with HTTP 401. It indicates Authorization header is not set properly
45	Auth token is not valid	Corresponds with HTTP 401. It indicates Authorization token is not valid
59	Whatsapp Template doesn't exist Code	Corresponds with HTTP 406. Your message template doesn't exist

Authorization

OCA SMS API provides an authorization method for you to access our resources, which we primarily use Access Token JSON Web Token (JWT). You can get the Access Token by generating it on our API dashboard.

Generate Access Token

This is the initial display for users who have never generated an access token

Select the channel you want to generate an access token, then click the red button that says "Generate". then access token will be downloaded to your computer in the form of a .txt file.

Endpoint

Get Masking User

OCA Provides a collection of numbers (Masking) that can be used as the sender id number for each sms otp will be sent

HTTP Method : GET

Endpoint URL :

https://webapigw.ocatelkom.co.id/sms/v2/number

RESPONSE

Property	Type
sender_id	Array

SAMPLE RESPONSE

{
    "sender_id":[
        "OCA Telkom"
    ]
}

Send SMS OTP

HTTP Method : POST

Endpoint URL :

https://webapigw.ocatelkom.co.id/sms/v2/send-otp

Request Body:

Property	Type
sender_id	String (numbers or masking number that get from numbers collection)
receipent_number	String (Destination phone number)
message_body	String (Message body)

{
    "sender_id": "Telkom"
    "receipent_number": "+628123xxxxx"
    "message_body": "ini nomor otp anda 123456"
}

Response:

Response:

Property	Type
success	Boolean
msg_id	String

200

{
    "success": true,
    "msg_id": "xxxxftt5rd57u898xxxx"
}

SMS Detail / Status

HTTP Method : GET

Endpoint URL

https://webapigw.ocatelkom.co.id/sms/v2/otp-status/{{fill_with_msg_uid}}

Response

Property	Type
sender_id	SString (Phone numbers that get from numbers collection)
receipent_number	String (Destination phone number)
message_body	String (Message body)
msg_id	String
created_at	ISO Date
updated_at	ISO Date
status	String

{
    "total_sms": 1,
    "sender_id": "OCA Telkom",
    "receipent_number": "+62813xxxxxxx",
    "status": "submited",
    "country": "ID",
    "created_at":"2024-03-01T03:22:58.073Z", 
    "updated_at": "2024-03-01T03:22:58.073Z",
    "msg_id": "xxx961fc19f4aefi54fxxxx"
    }
}