# 基本概念
# 术语
- appKey & appSecret
- appKey & appSecret 是由新核云开放平台提供,使得第三方得以访问新核云数据的凭证。appKey 针对单一租户,暂不支持一个 appKey 对多租户。租户表示新核云 SAAS 平台单一组织数据集合。
- access_token & refresh_token
- access_token 是从新核云获取数据的重要凭证,由 appKey & appSecret 生成,所有接口访问过程中都需要携带此信息用于验证接口的访问权限。获取 Token 方式参考 认证 API
- access_token 携带在 HTTP header Authorization 里面。需要申明 『Bearer』类型。参考用法:
curl 'http://c2.xinheyun.com/api/openv2/items/query' \
-H 'Connection: keep-alive' \
-H 'Accept: application/json, text/plain, */*' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ0ZW5hbnRJZCI6ImE5NGRlYmUyLTlkNmEtNDkwNS1iZWQyLTQwMDg0OGJkMzM0OCIsImlzcyI6Im9wZW4tYXBpIiwiZXhwIjoxNTk5NDUzODk0LCJpYXQiOjE1OTk0NDY2OTQsInN0YWZmSWQiOiIxMDAwMTQ2NSJ9.a-ZAfOpIDSFx45UR3x2TfLQmCYZvGkeq9-iBP8ZvBO8'
--data-binary '{"name":"","start":0,"length":10000}' \
--compressed \
--insecure
- refresh_token 是在 access_token 过期之后,重新获取 access_token 的凭证。使用方法参考认证 API
# 架构
Webhook →