API通用规则
本部分内容是API调用的通用规则,包括请求和响应说明等内容,是全部接口的基础说明,请认真阅读本章节内容。
统一请求格式
BASE URL:
https://edc-api.totrial.com/{version}
其中,{version}为版本号,如当前的版本号为v1。
字符编码
统一默认为utf-8,也可在header中强制设置。
charset=UTF-8;
格式化响应
本API提供两种响应格式,xml和json,其中,默认响应是json格式。
要获取xml格式响应,请求中需要加入如下头部信息(header):“Accept: application/xml”。
至于json格式的响应,默认即是json,加入如下头部信息:“Accept: application/json” 亦可。
API Key
系统在申请审核成功后,会自动发送一封电子邮件到用户提供的电子邮箱中,其中就包括 API Key。
API Key是一个32位的字符串,每次API申请都需要添加在请求参数中:
access-token={API Key}
API Key 是系统授权的唯一凭证,请用户妥善保存,且不要泄漏给第三者,否则,因此造成的损失,由API Key持有者负责。
请求频率限制
当下请求频率默认限制为 10次/s。如需更高频率,需要特殊申请。