# Message APIs

## 1. Prerequisites

Base URL: `https://api.rokid.com`

## 2. Overview

The message module covers send, receive and storage so cloud services can talk with phones and glasses.

### 2.1 Send message

**Endpoint** `https://api.rokid.com/ar/core/openapi/push/messages`

**Method** `POST`

**Request** `application/json`

**Response** `*/*`

**Description** Push a message to the target device.

**Parameters**

| **Name** | **Description** | **Required** | **Type** |
| --- | --- | --- | --- |
| deviceId | Device SN | true | string |
| businessType | Business type; use `inspection` for Lingmou | true | string |
| source | Origin label, e.g. “Support” | true | string |
| title | Message title | true | string |
| introduction | Short intro | true | string |
| body | Message body | true | string |

**Example**

```json
curl -X POST https://api.rokid.com/ar/core/openapi/push/messages \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "deviceId":"YOUR_DEVICE_SN",
    "businessType":"inspection",
    "source":"Support",
    "title":"Sample title",
    "introduction":"Intro",
    "body":"Message body"
}'
```

**Sample response**

```json
{
    "code": 0,
    "message": "OK",
    "data": "success",
    "success": true
}
```
