OpenAPI概览

此文档适用于CloudCC One版本的OpenAPI接口。要查看当前系统版本，请登录系统web应用，进入设置-常规-公司信息，查看当前程序版本。

1.接口联调说明

1.1 Request Details

通过get请求CloudCC 公有云官方开发者地址接口：

拿到对应的组织api网关地址。例如：

{
    "result":true,
    "returnInfo":"",
    "returnCode":"1",
    "orgapi_address":"https://xxxx.apis.cloudcc.cn/lightningapi"
}

1.2 请求鉴权获取accessToken

请求接口地址：（Post方式）/api/cauth/token传入接口参数定义：

返回接口参数定义：

2. Rest API接口

请求方式：post返回接口参数定义中returnCode代码说明：

2.1 调用接口示例

以普通查询服务cquery为例：

• 服务地址：/openApi/common
• 请求服务名：cquery
• 请求参数类型：application/json
• 请求头：
  • 参数名称：accessToken；
  • 参数值：登陆接口获取的accessToken

入参示例：

{
    "serviceName": "cquery",
    "objectApiName": "Contact",
    "expressions": "name='13213'",
    "isAddDelete": "false",
    "fiel
    ds":"name,createdate,createbyid"
}

回参示例：

{
    "result":true,
    "returnInfo":"",
    "returnCode":"1",
    "data":[
        {
            "CCObjectAPI":"Contact",
            "name":"13213",
            "createdate":"2021-07-31 00:45:02",
            "id":"003202100BDF459HcI1R",
            "createbyid":"0052021103B4B6B4Kd02",
            "createbyidccname":null
        },
        {
            "CCObjectAPI":"Contact",
            "name":"13213",
            "createdate":"2021-08-24 22:03:20",
            "id":"0032021B4EBE055owhtZ",
            "createbyid":"0052021103B4B6B4Kd02",
            "createbyidccname":null
        }
    ]
}

2.2 accessToken验证服务

2.2.1 验证登录标识(accessToken)是否有效

• 请求方式：post
• 入参数据类型：json
• 请求服务地址：/openApi/common
• 请求服务名：isValidWithBinding
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.3 查询服务

• 请求方式：post
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken
• 入参数据类型：json

2.3.1 普通查询服务

• 请求服务地址：/openApi/common
• 请求服务名：cquery
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.3.2 带权限的普通查询服务

• 请求服务地址：/openApi/common
• 请求服务名：cqueryWithRoleRight
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.3.3 分页查询服务

• 请求服务地址：/openApi/common
• 请求服务名：pageQuery
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.3.4 带权限的分页查询服务

• 请求服务地址：/openApi/common
• 请求服务名：pageQueryWithRoleRight
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.3.5 获取对象查询权限

• 请求服务地址：/openApi/common
• 请求服务名：getQueryPermisson
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.3.6 自定义SQL查询（含配置权限控制）

• 请求服务地址：/openApi/common
• 请求服务名：cqlQueryWithLogInfo
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

expressions参数示例： select id,name,Account__c as Account__c from cloudcclead返回接口参数定义：

CCService使用方法：

List<CCObject> list=  this.cqlQueryWithLogInfo("Account","select id ,name,lead_c as lead_c from Account where id='001aaaaabbbbbccdddd' ",null)

2.3.7 静态查询接口

• 请求服务地址：/openApi/common
• 请求服务名：cqlQueryWithStatic
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

expressions参数示例： select id,name,Account__c as Account__c from cloudcclead返回接口参数定义：

CCService使用方法：

List<CCObject> list=  this.cqlQueryWithLogInfo("Account","select id ,name,lead_c as lead_c from Account where id='001aaaaabbbbbccdddd' ",null) ;

2.4 插入服务

• 请求方式：post
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken
• 入参数据类型：json

2.4.1 普通插入服务

• 请求服务地址：/openApi/common
• 请求服务名：insert
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

data数据格式：

[{key3:value3, key2:value2, key1:value1}, {key11:value11, key22:value22, key33:value33}]

返回接口参数定义：

2.4.2 带权限的插入服务

• 请求服务地址：/openApi/common
• 请求服务名：insertWithRoleRight
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.5 删除服务

• 请求服务地址：/openApi/common
• 请求方式：post
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken
• 入参数据类型：json

2.5.1 普通删除服务

• 请求服务地址：/openApi/common
• 请求服务名：delete
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.5.2 带权限的删除服务

• 请求服务地址：/openApi/common
• 请求服务名：deleteWithRoleRight
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.6 修改服务

• 请求方式：post
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken
• 入参数据类型：json

2.6.1 普通修改服务

• 请求服务地址：/openApi/common
• 请求服务名：update
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.6.2 带权限的修改服务

• 请求服务地址：/openApi/common
• 请求服务名：updateWithRoleRight
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.7 插入或者修改数据服务

• 请求方式：post
• 入参数据类型：json

2.7.1 普通插入或者修改数据服务

• 请求服务地址：/openApi/common
• 请求服务名：upsert
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.7.2 带权限的插入或者修改数据服务

• 请求服务地址：/openApi/common
• 请求服务名：upsertWithRoleRight
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.8 自助服务接口

• 请求方式：post
• 入参数据类型：json
• 请求服务地址：/openApi/common
• 请求服务名：customService
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.8.1 操作类型insert

请参考自助服务接口，无特别说明。

2.8.2 操作类型query

请先参考自助服务接口，此处说明的参数为可选参数，

传入接口参数定义：

2.8.3 操作类型update

请先参考自助服务接口，此处说明data参数数据结构和update专用参数。

data参数数据结构

传入接口参数定义：

2.8.4 操作类型delete

请参考自助服务接口，无特别说明。

2.8.5 操作类型queryCompare

请参考自动服务接口和操作类型query 说明

2.8.6 操作类型queryMsg

queryMsg先调用query接口查询数据，然后调用delete接口删除查询的数据。queryMsg接口返回query接口查询的数据。此接口请慎用，容易误删数据。

2.9 发送手机消息服务

• 请求方式：post
• 入参数据类型：json

2.9.1 手机消息服务

• 请求服务地址：/openApi/common
• 请求服务名：telMessage
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

data数据定义：

2.10 图片服务

• 请求方式：post

2.10.1 图片上传服务

• 请求服务地址：/openApi/file
• 请求服务名：uploadImg
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

传入接口参数data数据定义：

返回接口参数：

返回接口参数data数据定义：

2.10.2 多张图片上传服务

• 请求服务地址：/openApi/file
• 请求服务名：uploadImgMany
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

返回接口参数data数据定义：

2.10.3 获取图片属性

• 请求服务地址：/openApi/common
• 请求服务名：getImgProperty
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.11 文件上传服务(文件流方式)

• 请求服务地址：/openApi/file
• 请求方式：post
• 入参数据类型：formdata
• 请求服务名：uploadFile
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

返回接口参数data数据定义：

2.12 文件上传服务(base64方式)

• 请求服务地址：/openApi/common
• 请求服务名：uploadAttachement
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

2.13 文件下载服务

• 请求服务地址：/openApi/downloadFile
• 请求方式：Get

传入接口参数定义：

返回结果：以二进制流的形式返回文件，文件在InputStream里面

2.14 文件下载服务（base64格式）

• 请求服务地址：/openApi/common
• 请求服务名：downloadAttachement
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

2.15 删除附件

• 请求服务地址：/openApi/common
• 请求服务名：deleteAttachment
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

2.16 删除文件

• 请求服务地址：/openApi/common
• 请求服务名：deleteFile
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

2.17 发送邮件服务

• 请求服务地址：/openApi/common
• 请求方式：post
• 入参数据类型：json
• 请求服务名：sendEmail
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

data数据定义：

2.18 chatter接口

• 请求方式：post
• 请求头：
• 参数名称：accessToken
• 参数值：登陆接口获取的accessToken
• 入参数据类型：json

2.18.1 获取chatter内容

• 请求服务地址：/openApi/common
• 请求服务名：getChatters01
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.2 获取我追随的chatter内容

• 请求服务地址：/openApi/common
• 请求服务名：getMyChatter01
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.3 查询用户的追随者，以及被用户追随的人员

• 请求服务地址：/openApi/common
• 请求服务名：getFollowUsers
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.4 查询追随对象记录的人员

• 请求服务地址：/openApi/common
• 请求服务名：getRecordFollowUsers
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.5 查询微贴用户信息

• 请求服务地址：/openApi/common
• 请求服务名：getUserMapByIds
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.6 发布普通类型的帖子

• 请求服务地址：/openApi/common
• 请求服务名：addMicroPostF
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.7 发布文件类型的帖子

• 请求服务地址：/openApi/common
• 请求服务名：addMicroPostD
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.8 发布多个文件类型的帖子

• 请求服务地址：/openApi/common
• 请求服务名：addMicroPostDMany
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.9 发布链接类型的帖子

• 请求服务地址：/openApi/common
• 请求服务名：addMicroPostL
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.10 发布投票类型的帖子

• 请求服务地址：/openApi/common
• 请求服务名：addMicroPostV
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.11 投票接口

• 请求服务地址：/openApi/common
• 请求服务名：voteMicroPost
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.12 发布带文件的评论

• 请求服务地址：/openApi/common
• 请求服务名：addMicroCommentFile
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.13 发布普通的评论

• 请求服务地址：/openApi/common
• 请求服务名：addMicroComment
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.14 喜欢或取消喜欢帖子

• 请求服务地址：/openApi/common
• 请求服务名：praiseFeed
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.15 喜欢或取消喜欢评论

• 请求服务地址：/openApi/common
• 请求服务名：praiseComment
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.16 收藏或取消收藏帖子

• 请求服务地址：/openApi/common
• 请求服务名：favoriteFeed
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.17 删除帖子

• 请求服务地址：/openApi/common
• 请求服务名：removeMicroPost
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.18 删除评论

• 请求服务地址：/openApi/common
• 请求服务名：removeMicroComment
• 请求头：
  • 参数名称：accessToken
• 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.19 追随或取消追随操作

• 请求服务地址：/openApi/common
• 请求服务名：operateFollowRelation
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.20 查询人员信息

• 请求服务地址：/openApi/common
• 请求服务名：getChatterUserInfo
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.21 修改人员信息

• 请求服务地址：/openApi/common
• 请求服务名：updateChatterUserInfo
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.18.22 下载与Chatter相关的文件

• 请求服务地址：/openApi/common
• 请求服务名：downloadFileChatter
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回结果：以二进制流的形式返回文件，文件在InputStream里面

2.18.23 查询用户组接口

• 请求服务地址：/openApi/common
• 请求服务名：getGroupInfo
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.19 查询选项列表字段选项值

• 请求方式：post
• 入参数据类型：json
• 请求服务地址：/openApi/common
• 请求服务名：getPickListValue
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.20 选项列表以及记录类型依赖关系配置

• 请求方式：post
• 入参数据类型：json
• 请求服务地址：/openApi/common
• 请求服务名：saveDependency
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.21 审批接口

• 请求方式：post
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken
• 入参数据类型：json

2.21.1 查询待审批项目接口

• 请求服务地址：/openApi/common
• 请求服务名：getApprovalPaddingList
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

2.21.2 批准接口

• 请求服务地址：/openApi/common
• 请求服务名：doApproved
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.21.3 拒绝接口

• 请求服务地址：/openApi/common
• 请求服务名：doRejected
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.21.4 重新分配接口

• 请求服务地址：/openApi/common
• 请求服务名：doReassign
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.21.5 调回接口

• 请求服务地址：/openApi/common
• 请求服务名：reCall
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.21.6 提交审批接口

• 请求服务地址：/openApi/common
• 请求服务名：submitForApproval
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

传入接口参数data数据定义：

2.22 获取应用程序接口

• 请求方式：post
• 入参数据类型：json
• 请求服务地址：/openApi/common
• 请求服务名：getAppList
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.23 获取选项卡接口

• 请求方式：post
• 入参数据类型：json
• 请求服务地址：/openApi/common
• 请求服务名：getAllTabs
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.24 获取应用程序和选项卡接口

• 请求方式：post
• 入参数据类型：json
• 请求服务地址：/openApi/common
• 请求服务名：getAppAndTabList
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数定义：

2.25 获取搜索设置接口

• 请求方式：post
• 入参数据类型：json
• 请求服务地址：/openApi/common
• 请求服务名：getMySetupObjs
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

2.26 新建用户接口

• 请求方式：post
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken
• 入参数据类型：json

2.26.1 获取角色信息接口

• 请求服务地址：/openApi/common
• 请求服务名：searchRole
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken
• 传入接口参数定义：
• 返回接口参数：

2.26.2 获取简档信息接口

• 请求服务地址：/openApi/common
• 请求服务名：searchProfile
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken
• 传入接口参数定义：
• 返回接口参数：

2.26.3 新建用户接口

• 请求服务地址：/openApi/common
• 请求服务名：createUser
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken
• 传入接口参数定义：
• 返回接口参数：

2.26.4 获取用户头像信息接口

• 请求服务地址：/openApi/user/getPhotos
• 请求方式：POST
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken
• 传入接口参数定义：
• 返回接口参数：

2.26.5 展示用户头像接口

• 请求服务地址：/api/user/userPhoto
• 请求方式：GET
• 请求头：
  • 参数名称：accessToken
  • 参数值：登陆接口获取的accessToken

传入接口参数定义：

返回接口参数：

3.接口操作示例

3.1 通过get请求CloudCC 公有云官方开发者地址接口

拿到对应的组织api网关地址。例如：

{
    "result":true,
    "returnInfo":"",
    "returnCode":"1",
    "orgapi_address":"https://xxxx.apis.cloudcc.cn/lightningapi"
}

示例如下：

3.2 调用上面获得的域名/api/cauth/token 这个接口，进行登陆鉴权，获取到accessToken.

传参示例：

{
    "username":"",
    "safetyMark":"",
    "clientId":"",
    "secretKey":"",
    "orgId":"",
    "grant_type":"password"
}

回参示例：

{
    "data": {
        "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ2ZXJzaW9uVHlwZSI6IkVudGVycHJpc2UiLCJhdWQiOiJjbG91ZGNjIiwibG9naW5O"
    },
    "requestId": null,
    "returnCode": "1",
    "returnInfo": null,
    "result": true,
    "stackTrace": null,
    "errorSQL": null
}

3.2.1 安全标记来自于个人设置里的“重置我的安全标记”，会发到当前登录账号的邮箱里。

邮件内容如下：

3.2.2 ClientId和SecretKey，来自于安全性控制里的“连接的应用程序”。

3.3 根据需要调用增删改查接口，地址为：上面获得的接口域名/openApi/common
在请求头中(header)里，放入上面步骤二获得的accessToken

传参以cquery为例：

{
"serviceName": "cquery",
"objectApiName": "Contact",
"expressions": "name=’test11’",
"isAddDelete": "false",
"fields":"name,createdate,createbyid"
}

回参示例：

{
"result":true,"returnInfo":"",
"returnCode":"1",
"data":[{"CCObjectAPI":"Contact","name":"test11","createdate":"2021-02-02 11:06:05","id":"00320215C5835B4Lzh8p","createbyid":"005202008F608AAuoER1","createbyidccname":"biys系统管理员"},{"CCObjectAPI":"Contact","name":"test11","createdate":"2022-11-22 12:17:31","id":"003202254DBC0FF90tIf","createbyid":"005202008F608AAuoER1","createbyidccname":"biys系统管理员"}]
}

4.API Limits

SaaS版本的API调用受CloudCC 版本配额限制，On-prem版本除外，具体配额如下：

** 无论何种版本配额，禁止以超过CloudCC并发限制及调用频率对CLoudCC API进行超负荷的请求，如发现有异常违规请求，CloudCC有权对此API Client进行停用。

** 以上配额仅供参考，具体配额会随CLoudCC版本升级及技术架构进行调整，详情请关注CloudCC系统通知。