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

cainiao.guoguo.courier.graborder.getrealnameinfobyidentitycode (扫码获取实名信息)

扫码获取实名信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
identity_code_value String 必须 https://qr.alipay.com/icx00303s6bd8xop6tpj004e 身份码
identity_code_type Number 必须 1 身份码来源 1-支付宝 2-手淘
session_code String 必须 jiofjjwejrewr sessionCode
user_id Number 必须 74983748239432 小件员id

响应参数

名称 类型 示例值 描述
status_code String system_error 状态码
data GetRealNameInfoByIdentityCodeResponse 包装数据结果
  • real_name_info
  • RealNameInfo
  • 实名信息
  • └ cert_type
  • Number
  • 0
  • 证件类型,身份证-0
  • └ cert_no
  • String
  • 330101191101011111
  • 证件号
  • └ real_name
  • String
  • 张三
  • 真实姓名
  • └ sex
  • Number
  • 1
  • 性别,男-0,女-1
  • picture_list
  • RealNamePictureInfo []
  • 图片列表
  • └ type
  • String
  • certFront
  • 图片类型,证件正面照-certFront,证件反面照-certBack
  • └ url
  • String
  • https://www.taobao.com
  • 图片地址
is_success Boolean true 是否成功
status_message String 系统异常 状态描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoGuoguoCourierGraborderGetrealnameinfobyidentitycodeRequest req = new CainiaoGuoguoCourierGraborderGetrealnameinfobyidentitycodeRequest();
req.setIdentityCodeValue("https://qr.alipay.com/icx00303s6bd8xop6tpj004e");
req.setIdentityCodeType(1L);
req.setSessionCode("jiofjjwejrewr");
req.setUserId(74983748239432L);
CainiaoGuoguoCourierGraborderGetrealnameinfobyidentitycodeResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_guoguo_courier_graborder_getrealnameinfobyidentitycode_response>
    <status_code>system_error</status_code>
    <data>
        <real_name_info>
            <cert_type>0</cert_type>
            <cert_no>330101191101011111</cert_no>
            <real_name>张三</real_name>
            <sex>1</sex>
            <picture_list>
                <real_name_picture_info>
                    <type>certFront</type>
                    <url>https://www.taobao.com</url>
                </real_name_picture_info>
            </picture_list>
        </real_name_info>
    </data>
    <is_success>true</is_success>
    <status_message>系统异常</status_message>
</cainiao_guoguo_courier_graborder_getrealnameinfobyidentitycode_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

返回
顶部