# 集成基本概念

# 术语

  1. appKey & appSecret
  • appKey & appSecret 是由新核云开放平台提供,使得第三方得以访问新核云数据的凭证。appKey 针对单一租户,暂不支持一个 appKey 对多租户。租户表示新核云 SAAS 平台单一组织数据集合。
  1. access_token & refresh_token
  • access_token 是从新核云获取数据的重要凭证,由 appKey & appSecret 生成,所有接口访问过程中都需要携带此信息用于验证接口的访问权限。获取 Token 方式参考 认证 API
  • access_token 携带在 HTTP header Authorization 里面。需要申明 『Bearer』类型。参考用法:
 curl 'http://c2.xinheyun.com/api/metadata-app/v1/thirdParty/search/page' \
  -H 'Connection: keep-alive' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ0ZW5hbnRJZCI6ImE5NGRlYmUyLTlkNmEtNDkwNS1iZWQyLTQwMDg0OGJkMzM0OCIsImlzcyI6Im9wZW4tYXBpIiwiZXhwIjoxNTk5NDUzODk0LCJpYXQiOjE1OTk0NDY2OTQsInN0YWZmSWQiOiIxMDAwMTQ2NSJ9.a-ZAfOpIDSFx45UR3x2TfLQmCYZvGkeq9-iBP8ZvBO8'
  --data-binary '{"body":{"start":0,"length":20,"templateApiName":"template_HQ5Fg","filter":{"field_XcRZz__c":"A4"},"sorts":[{"fieldApiName":"field_XcRZz__c","sortType":"DESC"}]}}' \
  --compressed \
  --insecure

  • refresh_token 是在 access_token 过期之后,重新获取 access_token 的凭证。使用方法参考认证 API