新核云开放平台

# 集成基本概念

# 术语

  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://lite.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