API: sms/traffic - 引流信息报备 API

概览

sms/traffic 是 SUBMAIL 引流信息报备的查询、创建和删除 API。

使用 sms/traffic GET方式 可以查询当前账户下的引流信息报备信息。
使用 sms/traffic POST方式 可以创建引流信息并提交审核。
使用 sms/traffic DELETE方式 可以删除引流信息。

URL

https://api-v4.mysubmail.com/sms/traffic

支持格式

是否需要授权

是

参阅 API 授权和验证机制

sms/traffic GET 方法请求参数

成功返回

{
    "status": "success",
    "traffic":{
        "sms_signature": "【SUBMAIL】",
        "sms_type": 1,
        "is_loan_related": 0,
        "business_categories": "00",
        "business_breakdown": "02",
        "message_title": "验证码通知",
        "message": "【SUBMAIL】您的验证码是var(code),15分钟有效",
        "message_param_flg": 1,
        "message_param_type": "2",
        "message_param_length": "6",
        "mobile1": "15201893074",
        "mobile1_name": "张三",
        "mobile1_cert_id": "310001198911220034",
        "mobile1_type": 1,
        "mobile1_desc": "客服回访电话1",
        "mobile1_test": "1",
        "mobile1_test_date": "2025-12-11",
        "mobile1_test_desc": "0",
        "mobile2": "15221876708",
        "mobile2_name": "李四",
        "mobile2_cert_id": "342521199005261234",
        "mobile2_type": 1,
        "mobile2_desc": "客服回访电话2",
        "mobile2_test": "1",
        "mobile2_test_date": "2025-12-12",
        "mobile2_test_desc": "0",
        "url": "https://www.mysubmail.com/console/sms/overview",
        "target_url": "",
        "url_type": 2,
        "url_desc": "官网链接",
        "domain_icp": "ICP1234",
        "domain_company": "上海赛邮云计算有限公司",
        "domain_company_code": "1234",
        "status": 1,
        "create_at": "2025-12-12T13:54:34+08:00",
        "reject": ""
    }
}

注：1. status表示当前引流信息的报备状态，0=提交中、1=已报备到运营商、2=已通过生效、3=被驳回。
2. reject，status=3时有数据，表示驳回原因。

失败返回

{
    "status": "error",
    "code": 168,
    "msg": "record not found"
}

sms/traffic POST 方法请求参数

请求方式
http post
content-type: form-data

注：1. 一次报备最多可同时报备一个引流链接和两个引流号码。
2. 在提交引流号码或引流链接时，需同时提交相关的其他信息和证明材料。

成功返回示例

{
    "id",1980,
    "status": "success",
}

失败返回示例

{
    "status": "error",
    "code": 160,
    "msg": "message_title parameter error"
}

sms/traffic DELETE 方法请求参数

成功返回

{
    "status": "success",
}

失败返回

{
    "status": "error",
    "code": 168,
    "msg": "record not found"
}

错误代码

参阅 API 错误代码