文档中心 > API类目 > 驿马前台api

cainiao.yima.postman.info.import (小件员信息导入)

同步小件员通讯录信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
alipay_account String 可选 21122@163.com 支付宝账号
avatar_url String 可选 http//.... 小件员头像
city String 必须 杭州市 城市名称
company_name String 必须 德邦快递 公司名称
cp_code String 必须 DBKD 菜鸟为每家公司统一分配的code
cp_user_id String 必须 22222 作为标识小件员的唯一id,一般为快递公司系统的Uid,使用账号密码登陆的,需传登陆账号
employee_no String 可选 22222 快递公司工号
identity_card String 可选 334444444444559595555 小件员身份证账号
name String 必须 王捶捶 小件员姓名
oper_type String 必须 0 操作类型;0:新增 1:修改 2:废弃
password String 可选 123456 密码,仅通过账号密码方式的公司传入
phone String 必须 12290909090 小件员手机号
remark String 可选 “” 备注扩展字段
scope String 可选 23333 揽派范围
work_station String 可选 余杭区乐佳国际 网点名称
work_station_addr_area String 可选 余杭区 网点地址-区
work_station_addr_city String 可选 杭州 网点地址城市
work_station_addr_detail String 可选 浙江省杭州市余杭区仓前街道乐佳国际 网点详细地址
work_station_addr_province String 可选 浙江省 网点地址-省
work_station_addrtreet String 可选 仓前街道 网点地址-街道
work_station_code String 可选 33333 网点编码

响应参数

名称 类型 示例值 描述
status_code String 1 errorCode
status_message String 传入的手机号为空 errorMessage
is_success Boolean false 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoYimaPostmanInfoImportRequest req = new CainiaoYimaPostmanInfoImportRequest();
req.setAlipayAccount("21122@163.com");
req.setAvatarUrl("http//....");
req.setCity("杭州市");
req.setCompanyName("德邦快递");
req.setCpCode("DBKD");
req.setCpUserId("22222");
req.setEmployeeNo("22222");
req.setIdentityCard("334444444444559595555");
req.setName("王捶捶");
req.setOperType("0");
req.setPassword("123456");
req.setPhone("12290909090");
req.setRemark("“”");
req.setScope("23333");
req.setWorkStation("余杭区乐佳国际");
req.setWorkStationAddrArea("余杭区");
req.setWorkStationAddrCity("杭州");
req.setWorkStationAddrDetail("浙江省杭州市余杭区仓前街道乐佳国际");
req.setWorkStationAddrProvince("浙江省");
req.setWorkStationAddrtreet("仓前街道");
req.setWorkStationCode("33333");
CainiaoYimaPostmanInfoImportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_yima_postman_info_import_response>
    <status_code>1</status_code>
    <status_message>传入的手机号为空</status_message>
    <is_success>false</is_success>
</cainiao_yima_postman_info_import_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>

错误码解释

错误码 错误描述 解决方案
operate invalid 手机号码需要保持唯一 请检查传入的phone字段是否为唯一
45 删除小件员出错 请先调用cainiao.yima.postmaninfo.is.insert 判断通讯录信息是否存在
44 更新小件员出错 请先使用cainiao.yima.postmaninfo.is.insert 判断通讯录是否已经录入
505 城市信息不能为空 请检查city字段
503 小件员手机号不能为空 请检查phone字段
506 小件员手机号格式不正确 请检查phone字段是否为标准的手机号码格式
insert-failed 重复插入错误 请先调用cainiao.yima.postmaninfo.is.insert 判断通讯录信息是否存在

API工具

如何获得此API

FAQ

返回
顶部