获取短信验证码 GET

通过以下接口，您可以获取一条短信验证码，验证码数据会存储到数据库中的 sys_codes 表中。

http://您已备案域名/v5/sys/code?phone=18888888888

请求示例

注意修改大括号中的内容。App ID、API Key、Secret Key 请前往仪表盘获取。sign 为签名，签名方式详见请求签名。

cURL

curl --location --request GET 'http://您已备案域名/v5/sys/code?phone=18888888888' \
--header 'X-T1Y-Application-ID: {{app_id}}' \
--header 'X-T1Y-Api-Key: {{api_key}}' \
--header 'X-T1Y-Safe-NonceStr: {{客户端随机生成的32位随机码}}' \
--header 'X-T1Y-Safe-Timestamp: {{Unix时间戳，精确到秒}}' \
--header 'X-T1Y-Safe-Sign: {{MD5(path+app_id+api_key+客户端随机生成的32位随机码+Unix时间戳+Secret_Key)}}'

cURL-Windows

curl --location --request GET "http://您已备案域名/v5/sys/code?phone=18888888888" ^
--header "X-T1Y-Application-ID: {{app_id}}" ^
--header "X-T1Y-Api-Key: {{api_key}}" ^
--header "X-T1Y-Safe-NonceStr: {{客户端随机生成的32位随机码}}" ^
--header "X-T1Y-Safe-Timestamp: {{Unix时间戳，精确到秒}}" ^
--header "X-T1Y-Safe-Sign: {{MD5(path+app_id+api_key+客户端随机生成的32位随机码+Unix时间戳+Secret_Key)}}"

响应示例

操作成功时 http 状态码以及 code 永远是 200。发送成功会返回 objectId ，该 ID 是该验证码在数据库中的唯一标识信息。若需校验响应数据请参考响应签名校验（可选）。

成功示例

{
    "code": 200,
    "data": {
        "objectId": "65435f093b239fddbc3f646e"
    },
    "message": "ok"
}

异常示例

{
    "code": 400,
    "data": null,
    "message": "This is an exception message."
}