feat(gateway): 新增接口11和61的鉴权与测试页
This commit is contained in:
+32
-5
@@ -55,8 +55,9 @@
|
||||
|
||||
<div class="toc">
|
||||
<a href="#overview">通用约定</a>
|
||||
<a href="#client-auth">22／42／52／72 鉴权</a>
|
||||
<a href="#client-auth">客户端鉴权</a>
|
||||
<a href="#if1">接口1</a>
|
||||
<a href="#if11">接口11</a>
|
||||
<a href="#if2">接口2</a>
|
||||
<a href="#if22">接口22</a>
|
||||
<a href="#if3">接口3</a>
|
||||
@@ -65,6 +66,7 @@
|
||||
<a href="#if5">接口5</a>
|
||||
<a href="#if52">接口52</a>
|
||||
<a href="#if6">接口6</a>
|
||||
<a href="#if61">接口61</a>
|
||||
<a href="#if72">接口72</a>
|
||||
<a href="#errors">错误码</a>
|
||||
<a href="#test">在线测试</a>
|
||||
@@ -79,7 +81,7 @@
|
||||
<tr><td>请求方式</td><td>业务接口使用 POST。验证令牌使用 GET。</td></tr>
|
||||
<tr><td>编码</td><td>UTF-8</td></tr>
|
||||
<tr><td>Content-Type</td><td>传图使用 <code>multipart/form-data</code>，登录和刷新使用 <code>application/json</code></td></tr>
|
||||
<tr><td>客户端鉴权</td><td>22、42、52、72 使用 <a class="link" href="#client-auth">Bearer 访问令牌</a>。</td></tr>
|
||||
<tr><td>客户端鉴权</td><td>11、22、42、52、61、72 使用 <a class="link" href="#client-auth">Bearer 访问令牌</a>。</td></tr>
|
||||
<tr><td>图片参数</td><td>三选一：<code>image_file</code>（文件上传）/ <code>image_url</code>（URL）/ <code>image_base64</code>（base64 + 前缀）</td></tr>
|
||||
<tr><td>图片格式</td><td>JPG / PNG，单人正面照</td></tr>
|
||||
<tr><td>请求体上限</td><td><strong>2MB</strong>（nginx 层限制）。超限直接返回 HTTP <strong>413</strong>，不会进入业务逻辑。建议图片文件 ≤1MB；<code>image_base64</code> 传图会膨胀约 33%，编码前原图建议 ≤1.4MB。手机直拍照片通常 3~8MB，<strong>上传前务必先压缩</strong>（如最长边缩到 1500px、JPEG 质量 80）。<code>image_url</code> 方式图片在远端，不受此限制</td></tr>
|
||||
@@ -96,9 +98,10 @@
|
||||
</div>
|
||||
|
||||
<div class="card" id="client-auth">
|
||||
<h2>22／42／52／72 客户端鉴权</h2>
|
||||
<h2>客户端鉴权</h2>
|
||||
<div class="card-body">
|
||||
<p>使用同一个访问令牌调用 <a href="#if22">22</a>、<a href="#if42">42</a>、<a href="#if52">52</a> 和 <a href="#if72">72</a>。账号为 <code>yonghe</code>，密码由对接人员提供。客户端发送 <code>Authorization: Bearer <access_token></code>。</p>
|
||||
<p>客户端发送 <code>Authorization: Bearer <access_token></code>。账号为 <code>yonghe</code>，密码由对接人员提供。以下接口共用同一个访问令牌。</p>
|
||||
<p><a href="#if11">接口 11</a>、<a href="#if22">接口 22</a>、<a href="#if42">接口 42</a>、<a href="#if52">接口 52</a>、<a href="#if61">接口 61</a>、<a href="#if72">接口 72</a></p>
|
||||
|
||||
<div class="guide-step">
|
||||
<h3>1. 登录获取令牌</h3>
|
||||
@@ -187,6 +190,17 @@ const { code, data } = await res.json();
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="card" id="if11">
|
||||
<h2>11. 四庭七眼测量（鉴权） <span class="badge post">POST</span> <code>/api/v1/face/measure-11</code></h2>
|
||||
<div class="card-body">
|
||||
<p>请求使用 <a href="#client-auth">Bearer 访问令牌</a>，图片参数和响应字段见<a href="#if1">接口 1</a>。返回四庭七眼测量数据和透明标注图 URL。</p>
|
||||
<pre>curl -sS -X POST "$BASE_URL/api/v1/face/measure-11" \
|
||||
-H "Authorization: Bearer $ACCESS_TOKEN" \
|
||||
-F 'image_file=@photo.jpg'</pre>
|
||||
<p><a href="/static/test_interface11_auth.html" class="link">打开接口 11 测试页</a></p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- ======== 接口2 ======== -->
|
||||
<div class="card" id="if2">
|
||||
<h2>2. C端生发 <span class="badge post">POST</span> <code>/api/v1/hair/grow</code></h2>
|
||||
@@ -455,6 +469,17 @@ console.log(features.gene_style); // "自然型"</pre>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="card" id="if61">
|
||||
<h2>61. 四庭七眼测量 v2（鉴权） <span class="badge post">POST</span> <code>/api/v1/face/measure-61</code></h2>
|
||||
<div class="card-body">
|
||||
<p>请求使用 <a href="#client-auth">Bearer 访问令牌</a>，图片参数和响应字段见<a href="#if6">接口 6</a>。返回去顶庭的测量数据和透明标注图 URL。</p>
|
||||
<pre>curl -sS -X POST "$BASE_URL/api/v1/face/measure-61" \
|
||||
-H "Authorization: Bearer $ACCESS_TOKEN" \
|
||||
-F 'image_file=@photo.jpg'</pre>
|
||||
<p><a href="/static/test_interface61.html" class="link">打开接口 61 测试页</a></p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="card" id="if72">
|
||||
<h2>72. B 端五个关键点 <span class="badge post">POST</span> <code>/api/v1/face/b-end-points</code></h2>
|
||||
<div class="card-body">
|
||||
@@ -487,7 +512,7 @@ console.log(features.gene_style); // "自然型"</pre>
|
||||
|
||||
<tr><td>1007</td><td>图片参数错误 / 后端不可用</td><td>参数传错 / 服务繁忙请稍后重试</td></tr>
|
||||
<tr><td>1008</td><td>图片格式不支持</td><td>非 JPG/PNG / base64 解码失败</td></tr>
|
||||
<tr><td>1009</td><td>未授权</td><td>HTTP 401。登录凭据错误，或 42／52／72 所需的令牌缺失、无效或过期。按 <a href="#client-auth">鉴权流程</a> 处理。</td></tr>
|
||||
<tr><td>1009</td><td>未授权</td><td>HTTP 401。登录凭据错误，或所需的访问令牌缺失、无效或过期。按 <a href="#client-auth">鉴权流程</a> 处理。</td></tr>
|
||||
</table>
|
||||
<p style="font-size:12px;color:#94a3b8;margin-top:8px">注：1004 仍在使用（接口2/5 的 gender 校验）；接口7（grow-v2）已弃用，请改用接口2。</p>
|
||||
<p style="font-size:12px;color:#dc2626;margin-top:8px">先检查 HTTP 状态和 <code>Content-Type</code>，再解析 JSON。HTTP 200 仍需检查 <code>code</code>，只有 <code>0</code> 表示成功。HTTP 401 的 JSON 用于鉴权提示与刷新。上传超限可能返回 HTTP 413，网关异常可能返回 502／504，这些响应可能是 HTML。</p>
|
||||
@@ -501,6 +526,7 @@ console.log(features.gene_style); // "自然型"</pre>
|
||||
<table>
|
||||
<tr><th>接口</th><th>测试页</th><th>功能</th></tr>
|
||||
<tr><td>1. 四庭七眼</td><td><a href="/static/test_interface1.html" class="link">/static/test_interface1.html</a></td><td>上传照片 → 原图+标注叠加，底图/标注开关，指标卡片</td></tr>
|
||||
<tr><td>11. 四庭七眼（鉴权）</td><td><a href="/static/test_interface11_auth.html" class="link">/static/test_interface11_auth.html</a></td><td>登录、测试鉴权、刷新令牌、四庭七眼测量</td></tr>
|
||||
<tr><td>2. C端生发</td><td><a href="/static/test_interface2.html" class="link">/static/test_interface2.html</a></td><td>上传+性别 → 方案一覧（原图/叠加/生发），双图对比</td></tr>
|
||||
<tr><td>22. 生发密度与发际线高度</td><td><a href="/static/test_interface22.html" class="link">/static/test_interface22.html</a></td><td>登录后生成，支持密度多选和发际线高度预览</td></tr>
|
||||
<tr><td>3. B端生发</td><td><a href="/static/test_interface3.html" class="link">/static/test_interface3.html</a></td><td>划线图上传 → 生发效果图</td></tr>
|
||||
@@ -510,6 +536,7 @@ console.log(features.gene_style); // "自然型"</pre>
|
||||
<tr><td>52. 发际线新规则</td><td><a href="/static/test_interface52.html" class="link">/static/test_interface52.html</a></td><td>登录、测试鉴权、刷新令牌、发际线预览与生发</td></tr>
|
||||
<tr><td>72. B 端五个关键点</td><td><a href="/static/test_interface72.html" class="link">/static/test_interface72.html</a></td><td>登录、测试鉴权、刷新令牌、关键点和虚线标注</td></tr>
|
||||
<tr><td>6. 四庭七眼 v2</td><td><a href="/static/test_interface6.html" class="link">/static/test_interface6.html</a></td><td>同接口1，去顶庭 · 竖线发际线→下巴 · 无头部端线</td></tr>
|
||||
<tr><td>61. 四庭七眼 v2（鉴权）</td><td><a href="/static/test_interface61.html" class="link">/static/test_interface61.html</a></td><td>登录、测试鉴权、刷新令牌、三庭测量</td></tr>
|
||||
<tr><td>9. 头发遮罩</td><td><a href="/static/test_interface9.html" class="link">/static/test_interface9.html</a></td><td>上传照片 → 头发遮罩 + 分步可视化</td></tr>
|
||||
<tr><td>10. 外缘膨胀带</td><td><a href="/static/test_interface10.html" class="link">/static/test_interface10.html</a></td><td>上传照片 → 头部外缘带状遮罩 + 分步可视化</td></tr>
|
||||
<tr><td>99. 人脸特殊点</td><td><a href="/static/test_interface99.html" class="link">/static/test_interface99.html</a></td><td>上传照片 → 60 关键点 + 5 发际线点坐标（<strong>测试大图请先压缩到 2MB 内</strong>，见通用约定）</td></tr>
|
||||
|
||||
Reference in New Issue
Block a user