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

cainiao.guoguo.courier.graborder.orderrealname (快递员端实人认证)

快递员端ocr实人认证 或者 手动输入

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
user_id Number 必须 234234234 快递员id
session_code String 必须 23423532s 快递员session
cert_type Number 可选 0 证件类型:0:身份证,1护照,2军官证,3士兵证,4回乡证,5临时身份证,6户口薄,7警官证,8台胞证, * 9营业执照,10其它证件,11港澳居民来往内地通行证,12台湾居民来往大陆通行证, 13驾照
auth_way String 可选 OCR_SCAN 认证方式:ONLINE_SCAN在线扫码; * OFFLINE_UPLOAD线下上传; * STATION_SYNC,驿站同步; * HAND_INPUT,手动输入; * OCR_SCAN在线扫照片;
cert_json String 可选 {"realName":"张三","address":"杭州市西湖区西溪首座"} 证件信息json
order_id Number 必须 234235235 订单id
skip Number 必须 1 是否跳过,1跳过,0不跳过

响应参数

名称 类型 示例值 描述
status_code String isv.invalid-parameter 错误码
data OrderRealNameResDto {} {}
  • └ sapphire_cert_id
  • String
  • 32423423
  • 快递线的认证记录id
is_success Boolean false success
status_message String 服务不可用 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoGuoguoCourierGraborderOrderrealnameRequest req = new CainiaoGuoguoCourierGraborderOrderrealnameRequest();
req.setUserId(234234234L);
req.setSessionCode("23423532s");
req.setCertType(0L);
req.setAuthWay("OCR_SCAN");
req.setCertJson("{\"realName\":\"张三\",\"address\":\"杭州市西湖区西溪首座\"}");
req.setOrderId(234235235L);
req.setSkip(1L);
CainiaoGuoguoCourierGraborderOrderrealnameResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_guoguo_courier_graborder_orderrealname_response>
    <status_code>isv.invalid-parameter</status_code>
    <data>
        <sapphire_cert_id>32423423</sapphire_cert_id>
    </data>
    <is_success>false</is_success>
    <status_message>服务不可用</status_message>
</cainiao_guoguo_courier_graborder_orderrealname_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

返回
顶部