{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/Gmr2z1ueq","result":{"data":{"markdownRemark":{"html":"<h2 id=\"api认证机制\"><a href=\"#api%E8%AE%A4%E8%AF%81%E6%9C%BA%E5%88%B6\" aria-label=\"api认证机制 permalink\" class=\"anchor\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>API认证机制</h2>\n<p>所有接口均采用<strong>API Key</strong>认证机制。</p>\n<h3 id=\"请求头\"><a href=\"#%E8%AF%B7%E6%B1%82%E5%A4%B4\" aria-label=\"请求头 permalink\" class=\"anchor\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>请求头</h3>\n<table>\n<thead>\n<tr>\n<th>参数名</th>\n<th>参数值</th>\n<th>说明</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Authorization</td>\n<td>Bearer {您的API Key}</td>\n<td>在百度智能云控制台获取的API Key，前缀为<code>bce-v3/</code></td>\n</tr>\n</tbody>\n</table>\n<h2 id=\"通信协议\"><a href=\"#%E9%80%9A%E4%BF%A1%E5%8D%8F%E8%AE%AE\" aria-label=\"通信协议 permalink\" class=\"anchor\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>通信协议</h2>\n<p>支持HTTP和HTTPS两种调用方式。为了提升数据的安全性，建议通过HTTPS调用。</p>\n<h2 id=\"请求结构说明\"><a href=\"#%E8%AF%B7%E6%B1%82%E7%BB%93%E6%9E%84%E8%AF%B4%E6%98%8E\" aria-label=\"请求结构说明 permalink\" class=\"anchor\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>请求结构说明</h2>\n<p>请求结构中包括的组成说明：</p>\n<table>\n<thead>\n<tr>\n<th>参数类型</th>\n<th>说明</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>HTTP Method</td>\n<td>HTTP请求方法，它告诉服务您正在请求什么类型的操作</td>\n</tr>\n<tr>\n<td>HEADER</td>\n<td>通过HTTP头域传入，如：host，Authorization</td>\n</tr>\n<tr>\n<td>URI</td>\n<td>通常用于指明操作实体，如：GET /api/skills/v1/{ep-id}/metadata</td>\n</tr>\n<tr>\n<td>Query参数</td>\n<td>URL中携带的请求参数，通常用来指明要对实体进行的动作</td>\n</tr>\n<tr>\n<td>RequestBody</td>\n<td>通过JSON格式组织的请求数据体</td>\n</tr>\n</tbody>\n</table>\n<p>数据交换格式为JSON，所有RequestBody、ResponseBody内容均采用UTF-8编码。</p>\n<h2 id=\"响应结构说明\"><a href=\"#%E5%93%8D%E5%BA%94%E7%BB%93%E6%9E%84%E8%AF%B4%E6%98%8E\" aria-label=\"响应结构说明 permalink\" class=\"anchor\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>响应结构说明</h2>\n<p>响应值分为两种形式：</p>\n<table>\n<thead>\n<tr>\n<th>响应内容</th>\n<th>说明</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>HTTP STATUS CODE</td>\n<td>如200，400，403，404等</td>\n</tr>\n<tr>\n<td>ResponseBody</td>\n<td>通过JSON格式组织的响应数据体</td>\n</tr>\n</tbody>\n</table>\n<h2 id=\"服务域名\"><a href=\"#%E6%9C%8D%E5%8A%A1%E5%9F%9F%E5%90%8D\" aria-label=\"服务域名 permalink\" class=\"anchor\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>服务域名</h2>\n<table>\n<thead>\n<tr>\n<th>区域</th>\n<th>服务端点Endpoint</th>\n<th>协议</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>全局</td>\n<td>yijian-next.cloud.baidu.com</td>\n<td>HTTP and HTTPS</td>\n</tr>\n</tbody>\n</table>\n<h2 id=\"错误码\"><a href=\"#%E9%94%99%E8%AF%AF%E7%A0%81\" aria-label=\"错误码 permalink\" class=\"anchor\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>错误码</h2>\n<h3 id=\"错误码格式\"><a href=\"#%E9%94%99%E8%AF%AF%E7%A0%81%E6%A0%BC%E5%BC%8F\" aria-label=\"错误码格式 permalink\" class=\"anchor\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a>错误码格式</h3>\n<p>当用户访问API出现错误时，会返回给用户相应的错误码和错误信息，便于定位问题，并做出适当的处理。</p>\n<table>\n<thead>\n<tr>\n<th>错误码</th>\n<th>说明</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>401</td>\n<td>认证失败，API Key无效或缺失</td>\n</tr>\n<tr>\n<td>404</td>\n<td>技能端点不存在</td>\n</tr>\n<tr>\n<td>400</td>\n<td>请求参数不合法</td>\n</tr>\n<tr>\n<td>500</td>\n<td>服务器内部错误</td>\n</tr>\n</tbody>\n</table>","fields":{"slug":"Gmr2z1ueq","title":"通用说明","date":"2026-07-02","extractedHeadings":[]},"headings":[{"value":"API认证机制","depth":2},{"value":"请求头","depth":3},{"value":"通信协议","depth":2},{"value":"请求结构说明","depth":2},{"value":"响应结构说明","depth":2},{"value":"服务域名","depth":2},{"value":"错误码","depth":2},{"value":"错误码格式","depth":3}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Gmr2z1ueq","prev":{"id":"umr2z1gf9","name":"API功能更新记录","path":"umr2z1gf9","filePath":"API参考/API功能更新记录.md","seo":null,"parentIds":["zmnssc1po"],"parents":[{"id":"zmnssc1po","documentId":"5f7de8a0-f500-46e5-8fe1-a837f3b92cd2","name":"API参考","repoName":"yijian","filePath":"API参考","disabled":false,"path":"zmnssc1po","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"next":{"id":"ymr2z1ghi","name":"技能相关接口","path":"ymr2z1ghi","filePath":"API参考/技能相关接口.md","seo":null,"parentIds":["zmnssc1po"],"parents":[{"id":"zmnssc1po","documentId":"5f7de8a0-f500-46e5-8fe1-a837f3b92cd2","name":"API参考","repoName":"yijian","filePath":"API参考","disabled":false,"path":"zmnssc1po","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"parents":[{"id":"zmnssc1po","documentId":"5f7de8a0-f500-46e5-8fe1-a837f3b92cd2","name":"API参考","repoName":"yijian","filePath":"API参考","disabled":false,"path":"zmnssc1po","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}],"specificSeo":null}}}