文档中心 > API类目 > 菜鸟裹裹API

cainiao.pickup.person.relation.confirm (自提柜异常件用户身份核验)

根据外部合作方提供的运单号、快递公司编号、收件人手机号、查询原因以及包裹相关属性,核验运单号--和外部传入的手机号是否是收件人关系。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
mail_no String 必须 24766728832 运单号
phone String 必须 13000000000 收件人手机号
feature String 可选 {"bizType“:1}
  • 默认值:扩展字段
  • 外部回传过来的扩展字段
    company_code String 可选 sudiyi.cn 柜子公司code

    响应参数

    名称 类型 示例值 描述
    data Boolean true 数据
    result_error_desc String 未知异常 异常描述
    result_is_success Boolean true 请求是否成功
    result_error_code String 1000 异常编码
    retry Boolean true 重试

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoPickupPersonRelationConfirmRequest req = new CainiaoPickupPersonRelationConfirmRequest();
    req.setMailNo("24766728832");
    req.setPhone("13000000000");
    req.setFeature("{\"bizType“:1}");
    req.setCompanyCode("sudiyi.cn");
    CainiaoPickupPersonRelationConfirmResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_pickup_person_relation_confirm_response>
        <data>true</data>
        <result_error_desc>未知异常</result_error_desc>
        <result_is_success>true</result_is_success>
        <result_error_code>1000</result_error_code>
        <retry>true</retry>
    </cainiao_pickup_person_relation_confirm_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部