1. 准备工作

1.1. 获取 API 访问凭证

  • 如果使用 v1/** 版本API ,则需要获取openid，openid代表一个企业的一个用户身份，调用接口时需要带上openid，以用户身份请求接口, openid长期有效。用户获取openid ,需要用户先授权，授权只需要成功一次。

1.1.1. 用户授权

用户授权操作步骤如下：

1.构建授权链接，https://openapi.77hub.com/auth/openid?requestId=KLJOISUVMDIE9231J55V&accessKeyId=AKIAZBYYYYYYYJILJNOQ&redirectUrl=https://yunfeng.77hub.com/&grantType=code，并在浏览器中打开该链接打开，进入链接如下图所示：

2.输入企企用户名，密码，点击登录，选择租户

3.选择租户后，例如选择北京企企科技有限公司，点击北京企企科技有限公司，用户即授权成功

1.1.2. 获取openid

  1. 获取openid 详情地址：https://openapi.77hub.com/doc/open_id.html#%E8%8E%B7%E5%8F%96openid
  2. 用户授权后，前端会重定向到redirectUrl，code和requestId作为redirectUrl的参数，本案例redirectUrl设为https://yunfeng.77hub.com/，所以此时前端重定到 https://yunfeng.77hub.com/?code=867ef8de729141429e3b2287e1d2e129&requestId=KLJOISUVMDIE9231J55V页面，code 作为参数。

  3. 根据2中返回的code ,调用 v1/code 接口获取openid 接口请求:

    v1/code 接口调用如下：

curl -X GET 'https://api2.77hub.com/v1/code?code=867ef8de729141429e3b2287e1d2e129' \
-H 'Authorization: <此处请填写签名结果>' \
-H 'Access-Key-Id: <此处请填写accessKeyId>' \
-H 'X-Amz-Date: <此处请填写请求时间，与获取签名的请求时间一致>' \
-H 'Content-Type: application/json'

接口返回：

 {"openid":"openid128kjsiiyysdlq7"}

1.1.3. 接口签名

调用接口必有签名，获取签名详情请参考：https://openapi.77hub.com/doc/api_sign.html

results matching ""

    No results matching ""