Introduction
The CINNOX Open API Operations provides endpoints to send SMS, OTP SMS, Get Number list, Get Push Notification and Patch TDR Event to your CINNOX service account.
<th style={{ textAlign: "left" }}>
Description
</th>
<th style={{ textAlign: "left" }}>
Remark
</th>
</tr>
<td style={{ textAlign: "left" }}>
This endpoint allows you to send an SMS message from your application.
</td>
<td style={{ textAlign: "left" }}>
* You can send an SMSmessage to multiple recipients with the same message at the same time.
* Currently, we do not support sending an SMS message to multiple recipients with multiple messages at the same time.
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
Post OTP SMS
</td>
<td style={{ textAlign: "left" }}>
This endpoint allows you to send OTP SMS from your application.
</td>
<td style={{ textAlign: "left" }}>
The pin format that we support:
* Numeric
* Alpha
* Alphanumeric
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
Get Number List
</td>
<td style={{ textAlign: "left" }}>
This endpoint allows you to query all numbers used in your CINNOX service, including:
* Virtual Numbers
* Service Numbers
* Alphanumeric Sender IDs
</td>
<td style={{ textAlign: "left" }}>
* Max data limit per request: 500 batch limit
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
Get Caller ID
</td>
<td style={{ textAlign: "left" }}>
This endpoint allows you to query details of Caller IDs, including:
* Types
* Expiry Date
* Name of Caller IDs
</td>
<td style={{ textAlign: "left" }}>
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
Get Staff Sender ID
</td>
<td style={{ textAlign: "left" }}>
This endpoint allows you to query details of the SMS sender IDs, including:
* Virtual numbers used as the sender ID,
* Countries from which the sender IDs originate
* Name of the sender IDs.
</td>
<td style={{ textAlign: "left" }}>
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
Get Event Hook List
</td>
<td style={{ textAlign: "left" }}>
This endpoint allows you to query the list of events you have subscribed to.
</td>
<td style={{ textAlign: "left" }}>
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
Create/Edit/Delete the Call Event Subscription
</td>
<td style={{ textAlign: "left" }}>
This endpoint allows you to create a new webhook Call event and edit the subscribed event for an application. It also allows you to delete the webhook event of a call under your application account.
</td>
<td style={{ textAlign: "left" }}>
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
Create/Edit/Delete the event subscription of the Inbound SMS Message
</td>
<td style={{ textAlign: "left" }}>
This endpoint allows you to create a new webhook event of the Inbound SMS Message and edit the subscribed event for an application. It also allows you to delete the subscribed event under your application account.
</td>
<td style={{ textAlign: "left" }}>
The event hook will return the following details:
* ID (Record ID)
* Event Description (Inbound SMS Message)
* Sender Number
* Recipient Number
* Time of receiving the Inbound SMS Message
* Content Type (Text)
* Content of the SMS Message
</td>
</tr>
<tr>
<td style={{ textAlign: "left" }}>
Create/Edit/Delete the event subscription of the Outbound SMS Message
</td>
<td style={{ textAlign: "left" }}>
This endpoint allows you to create a new webhook event of the outbound SMS Message and edit the subscribed event for an application. It also allows you to delete the subscribed event under your application account.
</td>
<td style={{ textAlign: "left" }}>
The event hook will return the following details:
* Serive ID of your CINNOX service
* The SMS ID of the outbound SMS message
* The SMS number of the recipient
* The Country Code of the SMS recipient
* The Response Code of the outbound SMS status
* The Status of the outbound SMS message
* The error message is when the SMS message sent or delivered failed.
</td>
</tr>
API Endpoint |
---|
Post SMS |
Important
In CINNOX, a single (1) SMS is limited to 160 chars for English text while 70 chars for non-English text (universal code), E.g., Chinese and Japanese scripts.
If the SMS text exceeds the single SMS limit, it splits into smaller messages for transmission.
A. SMS with English chars > 160 splits into 153-char per sent.
E.g., an SMS with 161 chars - will be sent as 2 SMS, first with 153 chars and the second with 8 chars.B. SMS with non-English chars > 70 splits into 67-char per sent.
E.g., an SMS with 71 chars - will be sent as 2 SMS, first with 67 chars and the second with 4 chars.When an SMS is combined with English and non-English chars, 1 non-English char is regarded as non-English text.
CINNOX Open API support up to 500 requests per min per service account.