授权

• 我们遵循标准的OAuth 2.0身份验证过程进行请求身份验证。
• 授权方式分为：客户端模式 和 授权码模式。
• 除非特殊场景需要，我们建议商户使用 客户端模式 进行更方便的对接。

授权参数

参数名	说明	示例
app_id	开发者唯一标识	7520b82387784
app_secret	开发者密钥	2039964434a08828828be16ef454f485
grant_type	授权方式	client_credentials,authorization_code

客户端模式

• 如果您只希望管理自己的 Pyvio帐户，请首先注册您的 Pyvio 帐户，然后联系我们以获得开发者权限。这将使您有权访问和管理自己的 Pyvio 帐户信息。
• grant_type: client_credentials.

授权码模式

• 如果您希望管理其他用户的信息，请首先注册 Pyvio帐户，然后联系我们以获得开发者权限，并按照流程获取用户授权。这将使您有权访问和管理其他用户的 Pyvio 帐户。
• grant_type: authorization_code.

API 基础参数

域名

• 沙箱环境: https://sandbox-api.pyvio.com
• 正式环境：https://api.pyvio.com

HTTP请求方式

• GET/POST

请求头参数

• Request-Id：当前的请求唯一ID，不能重复，推荐使用UUID
• Authorization：JWT 访问令牌
• Sign：所有的POST请求必须带上签名内容
• X-Timestamp：加签时候的时间戳（毫秒），用于Pyvio验签用
• content-Type：固定值application/json
• X-Unit-Id：当前要操作的子商户UnitId

提示

1. 所有接口请求在header里必须带上Request-Id参数。
2. 除了 获取令牌接口 外，所有接口请求在header里必须带上Authorization参数。
3. 所有的POST接口，必须进行签名（详情请查看 签名方式）。
4. 要操作子商户的数据，X-Unit-Id必须要填。