• 推送状态报告
    • 请求
    • 请求参数
    • 具体详解:
    • 推送json参数
    • 其中json示例为:

    推送状态报告

    功能说明:开通此接口后,我们将为您实时推送最新的状态报告。您需要提供一个url地址,接受http post请求。 该接口一次最多推送100个状态报告,为不影响推送速度,建议先接受数据后再做异步处理。

    备注:

    • 本功能默认不开启,如果开启请前往数据获取与推送页设置。

    • 所有带+86前缀的号码都会去掉+86

    • 接收到数据后,请从参数sms_status中取值,取到值使用urldecode解码后为实际json格式数据处理成功请返回字符串"SUCCESS"或"0",其他返回值将被认为是失败。该接口失败重试次数为3次,每次间隔5分钟。

    • 获取数据后,建议根据sid做去重。

    HTTP头信息:

    1. Accept:application/json;charset=utf-8;
    2. Content-Type:application/x-www-form-urlencoded;charset=utf-8;

    请求

    URL:http://your_receive_url_address

    注意:海外服务器地址 us.yunpian.com

    访问方式:POST

    请求参数

    参数名类型是否必须描述
    sms_statusstring经过urlencode编码的数据形式如:sms_status=urlencode(json)

    具体详解:

    推送的数据格式:

    1. <参数名>=<经过urlencode编码的数据>

    例如:

    1. sms_status=urlencode(json)

    服务端推送数据形式如下:

    1. curl --data "sms_status=url_encode_json" http://your_receive_url_address

    推送json参数

    名称类型描述
    error_detailstring运营商反馈代码的中文解释,仅供参考
    sidlong(64位)短信id,64位整型, 对应Java和C#的long,不可用int解析
    uidstring用户自定义id
    user_receive_timestring用户接收时间
    error_msgstring运营商返回的代码,如:"DB:0103"
    mobilestring接收手机号
    report_statusstring接收状态有:SUCCESS/FAIL,状态值无需引号

    其中json示例为:

    1. [
    2. {
    3. "error_detail": "接收成功",
    4. "sid": 9527,
    5. "uid": null,
    6. "user_receive_time": "2014-03-17 22:55:21",
    7. "error_msg": "DELIVRD",
    8. "mobile": "15205201314",
    9. "report_status": "SUCCESS"
    10. },
    11. {
    12. "error_detail": "接收成功",
    13. "sid": 9528,
    14. "uid": null,
    15. "user_receive_time": "2014-03-17 22:55:23",
    16. "error_msg": "DELIVRD",
    17. "mobile": "15212341234",
    18. "report_status": "SUCCESS"
    19. }
    20. ]