发送验证码短信

POST

/api/v1/sms_code

短信网关

平台对外的验证码短信接口。平台在后台固定配置模板 ID，调用方只需要传手机号、验证码内容和必要的模板变量即可。

请求参数

Authorization

API Key

在 header 添加参数

x-api-key

示例：

x-api-key: ********************

Body 参数application/json必填

示例

最少参数使用平台配置的模板编号使用模板变量对象传参

{
    "mobile": "13800000000",
    "code": "123456"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

最少参数使用平台配置的模板编号使用模板变量对象传参

curl --location '/api/v1/sms_code' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "mobile": "13800000000",
    "code": "123456"
}'

返回响应

🟢201

application/json

发送成功

Bodyapplication/json

示例

{
    "code": 0,
    "message": "发送成功",
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "priceSource": "default",
    "unitPrice": "0.1000",
    "data": {
        "productCode": "sms_code",
        "mobile": "13800000000",
        "templateId": "SMS_CODE_001"
    }
}

🟠403

🟠404

修改于 2026-05-11 11:39:57

ErrorResponse

发送通知短信