新增 LINE App 设备

POST

https://developer.salesmartly.com/api/v2/purchase-line-app

接口说明

在当前项目中按国家/地区分配一个 LINE App 云设备，返回 line_app_id 和初始状态 status=0（未连接）。

使用说明

使用 multipart/form-data 提交。country 为已有设备服务资源的国家/地区代码，首尾空白会被去除；示例 hk 不保证当前有可用资源。接口校验项目端口额度并选择启用且有空余容量的设备服务。创建成功后可在设备列表查看，使用 line_app_id 作为其余三个接口的 id。

每次成功调用都会新增一个设备；本接口不按请求内容去重。请求超时后请先检查设备列表，避免重复创建。

鉴权与响应

使用 external-sign 签名鉴权，project_id 为项目 ID。code=0 表示成功，非 0 表示失败；请同时检查业务状态码。设备必须属于当前鉴权项目。

业务错误码

400：请求参数错误。

212：项目端口额度不足。

222：指定国家/地区没有可用设备资源。

500：数据操作失败。

请求参数

Header 参数

Body 参数multipart/form-data必填

返回响应

🟢200

application/json

成功响应

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://developer.salesmartly.com/api/v2/purchase-line-app' \
--header 'external-sign;' \
--form 'project_id="example-project-id"' \
--form 'country="hk"'

响应示例

{
    "code": 0,
    "msg": "success",
    "request_id": "example-request-id",
    "data": {
        "line_app_id": 2001,
        "status": 0
    }
}

修改于 2026-09-11 10:23:11

新增 LINE App 设备

接口说明#

使用说明#