API认证机制

所有接口均采用API Key认证机制。

请求头

参数名	参数值	说明
Authorization	Bearer {您的API Key}	在百度智能云控制台获取的API Key，前缀为bce-v3/

通信协议

支持HTTP和HTTPS两种调用方式。为了提升数据的安全性，建议通过HTTPS调用。

请求结构说明

请求结构中包括的组成说明：

参数类型	说明
HTTP Method	HTTP请求方法，它告诉服务您正在请求什么类型的操作
HEADER	通过HTTP头域传入，如：host，Authorization
URI	通常用于指明操作实体，如：GET /api/skills/v1/{ep-id}/metadata
Query参数	URL中携带的请求参数，通常用来指明要对实体进行的动作
RequestBody	通过JSON格式组织的请求数据体

数据交换格式为JSON，所有RequestBody、ResponseBody内容均采用UTF-8编码。

响应结构说明

响应值分为两种形式：

响应内容	说明
HTTP STATUS CODE	如200，400，403，404等
ResponseBody	通过JSON格式组织的响应数据体

服务域名

区域	服务端点Endpoint	协议
全局	yijian-next.cloud.baidu.com	HTTP and HTTPS

错误码

错误码格式

当用户访问API出现错误时，会返回给用户相应的错误码和错误信息，便于定位问题，并做出适当的处理。

错误码	说明
401	认证失败，API Key无效或缺失
404	技能端点不存在
400	请求参数不合法
500	服务器内部错误