对接流程

本文档主要说明对接的一般流程：

• 开通开放平台接口调用权限。
• 接口鉴权方式。
• 如何换取用户token。
• 介绍调试方法和调试工具。

开通开放平台接口调用权限

请联系您的客服人员或商务经理进行开通，开通后企业才能调用。

接口鉴权方式

接口通过user token进行鉴权，调用接口时，需要在HTTP 请求header中添

Authorization: Token token=xxxxxxxx, device=open_api, version_code=9.9.9

Authorization说明

调用举例
调用域名参考： 开发须知

3、如何换取用户token

CorpId+用户手机+密码的方式进行接口调用鉴权换取

CURL 代码

curl --location --request POST '${host}/api/v2/auth/login' \
--header 'Content-Type: application/json' \
--data-raw '{
  "device": "open_api",
  "login": "{user phone}",
  "password": "{user password}",
  "corp_id": "organization corp id"
}'

CorpId获取
CorpId在公司信息界面可以获得

调试方法和调试工具

可以使用Postman对接口进行调试。

使用CURL命令

curl --location --request GET '${host}/api/v2/customers' \
--header 'Authorization: Token token={user token}, device=open_api, version_code=9.9.9:'