文档中心 > API类目 > 阿里通信API

alibaba.aliqin.ta.sms.num.query (短信查询)

查询短信发送揭露

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
biz_id String 可选 1234^1234 短信发送流水
rec_num String 必须 13000000000 短信接收号码
query_date String 必须 20151215 短信发送日期,支持近30天记录查询,格式yyyyMMdd
current_page Number 必须 1 分页参数,页码
page_size Number 必须 1 分页参数,每页数量。最大值50

响应参数

名称 类型 示例值 描述
current_page Number 1 当前页码
page_size Number 10 每页数量
total_count Number 100 总量
total_page Number 5 总页数
values FcPartnerSmsDetailDto [] 1 1
  • └ extend
  • String
  • 1234
  • 公共回传参数
  • └ rec_num
  • String
  • 1
  • 短信接收号码
  • └ result_code
  • String
  • 1
  • 错误码
  • └ sms_code
  • String
  • 1
  • 模板编码
  • └ sms_content
  • String
  • 1
  • 短信内容
  • └ sms_receiver_time
  • Date
  • 1
  • 短信接收时间
  • └ sms_send_time
  • Date
  • 1
  • 短信发送时间
  • └ sms_status
  • Number
  • 1
  • 发送状态 1:等待回执,2:发送失败,3:发送成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAliqinTaSmsNumQueryRequest req = new AlibabaAliqinTaSmsNumQueryRequest();
req.setBizId("1234^1234");
req.setRecNum("13000000000");
req.setQueryDate("20151215");
req.setCurrentPage(1L);
req.setPageSize(1L);
AlibabaAliqinTaSmsNumQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_aliqin_ta_sms_num_query_response>
    <current_page>1</current_page>
    <page_size>10</page_size>
    <total_count>100</total_count>
    <total_page>5</total_page>
    <values>
        <fc_partner_sms_detail_dto>
            <extend>1234</extend>
            <rec_num>1</rec_num>
            <result_code>1</result_code>
            <sms_code>1</sms_code>
            <sms_content>1</sms_content>
            <sms_receiver_time>1</sms_receiver_time>
            <sms_send_time>1</sms_send_time>
            <sms_status>1</sms_status>
        </fc_partner_sms_detail_dto>
    </values>
</alibaba_aliqin_ta_sms_num_query_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.MOBILE_NUMBER_ILLEGAL 号码格式错误 使用合法的手机号
isv.INVALID_PARAMETERS 参数异常 检查参数
isv.QUERY_DATE_ILLEGAL 查询日期不合法 只支持查询最近30天的记录
isv.SPLIT_PAGE_ILLEGAL 分页参数不合法 检查分页参数,最大支持每页100条记录

API工具

如何获得此API

FAQ

返回
顶部