queryContactList需要签名验签
集成商可调用此接口查询企业联系人列表。
报文结构
万里汇接口报文结构包括:请求头,请求体、响应体。
请求头
字段名 | 是否必传 | 范例 | 说明 |
Client-Id | 是 |
| 关于这些参数的解释说明,详见:请求头。 |
Signature | 是 |
| |
Content-Type | 是 |
| |
Request-Time | 是 |
| |
Connected-CustomerId | 否(有条件要求) |
| 当平台客户操作商户账户时需要传递 |
Access-Token | 有条件要求 |
| 当用 OAUTH 授权时需要传递 |
入参
出参
result Result REQUIRED
代表接口调用结果。
personList Array<PersonList> REQUIRED
企业联系人列表。
此字段只有当 result.resultStatus = S
时才会按需返回。
请求
响应
响应处理
集成商调用接口后,万里汇返回集成商API调用结果。result.resultStatus 字段取值范围为:
Result status | 描述 |
S | 接口调用成功 |
F | 接口调用失败,具体失败原因见result.resultCode |
U | 调用结果未知,需重试API请求。若问题依旧,联系万里汇技术支持。 |
result.resultCode
结果码 | 值 | 结果码信息 | 行动建议 |
---|---|---|---|
SUCCESS | S | Success | |
PARAM_ILLEGAL | F | Illegal parameters exist. For example, a non-numeric input, or an invalid date. | 参考API文档页面,确认请求头和传参是否正确 |
UNKNOWN_EXCEPTION | U | The API call is failed, which is caused by unknown reasons. | 服务器错误,若稍后重试问题依旧,联系万里汇技术支持以解决问题 |
SYSTEM_ERROR | F | System error. | 请勿重试,联系万里汇技术支持了解详情。 |
CONTRACT_NOT_EXIST | F | The contract check has failed. | 检查合约状态后重试。 |
ACCESS_TOKEN_EXPIRED | F | The access token has expired. | 刷新token接口以重新获取访问令牌(access token),或联系万里汇技术支持以解决问题 |
AUTHORIZATION_NOT_EXIST | F | The authorization does not exist. | 当前授权关系不存在,请联系万里汇技术支持检查授权关系。 |