feat(gateway): 接入接口22与账号鉴权测试页
This commit is contained in:
+19
-4
@@ -55,9 +55,10 @@
|
||||
|
||||
<div class="toc">
|
||||
<a href="#overview">通用约定</a>
|
||||
<a href="#client-auth">42/52/72 鉴权</a>
|
||||
<a href="#client-auth">22/42/52/72 鉴权</a>
|
||||
<a href="#if1">接口1</a>
|
||||
<a href="#if2">接口2</a>
|
||||
<a href="#if22">接口22</a>
|
||||
<a href="#if3">接口3</a>
|
||||
<a href="#if4">接口4</a>
|
||||
<a href="#if42">接口42</a>
|
||||
@@ -78,7 +79,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>仅 42、52、72 需要 <a class="link" href="#client-auth">Bearer 访问令牌</a>。其他原有业务接口沿用现有接入方式。</td></tr>
|
||||
<tr><td>客户端鉴权</td><td>22、42、52、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>
|
||||
@@ -95,9 +96,9 @@
|
||||
</div>
|
||||
|
||||
<div class="card" id="client-auth">
|
||||
<h2>42/52/72 客户端鉴权</h2>
|
||||
<h2>22/42/52/72 客户端鉴权</h2>
|
||||
<div class="card-body">
|
||||
<p>使用同一个访问令牌调用 <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>使用同一个访问令牌调用 <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>
|
||||
|
||||
<div class="guide-step">
|
||||
<h3>1. 登录获取令牌</h3>
|
||||
@@ -219,6 +220,19 @@ const { code, data } = await res.json();
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="card" id="if22">
|
||||
<h2>22. 生发密度与发际线高度 <span class="badge post">POST</span> <code>/api/v1/hair/grow-22</code></h2>
|
||||
<div class="card-body">
|
||||
<p>使用 <a href="#client-auth">Bearer 访问令牌</a>。图片字段三选一,发型序号男女均为 1–7。</p>
|
||||
<pre>curl -sS "$BASE_URL/api/v1/hair/grow-22" \
|
||||
-H "Authorization: Bearer $ACCESS_TOKEN" \
|
||||
-F "image_file=@./portrait.jpg" -F "gender=female" -F "hair_style=1,3" \
|
||||
-F "hair_density=sparse" -F "hair_density=dense" -F "hairline_height=0"</pre>
|
||||
<p>至少选择一档密度,多选时重复提交 <code>hair_density</code>。高度在 −1 到 +1 之间,API 的负值上移、正值下移。每个发型与密度组合返回一项,图片按网关规则转成 URL。</p>
|
||||
<p><a href="/static/test_interface22.html" class="link">打开接口 22 测试页</a></p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- ======== 接口3 ======== -->
|
||||
<div class="card" id="if3">
|
||||
<h2>3. B端生发(医生端) <span class="badge post">POST</span> <code>/api/v1/hair/grow-b</code></h2>
|
||||
@@ -446,6 +460,7 @@ console.log(features.gene_style); // "自然型"</pre>
|
||||
<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>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>
|
||||
<tr><td>4. 用户特征</td><td><a href="/static/test_interface4.html" class="link">/static/test_interface4.html</a></td><td>上传照片 → 7项面部特征 + 原始JSON</td></tr>
|
||||
<tr><td>42. 用户特征与两项判定</td><td><a href="/static/test_interface42.html" class="link">/static/test_interface42.html</a></td><td>登录、测试鉴权、刷新令牌、上传照片</td></tr>
|
||||
|
||||
Reference in New Issue
Block a user