POSTid-phote-create
证件照制作
提供证件照制作API服务，便于开发者快速制作证件照相关信息并集成到业务系统。
接入文件
证件照制作接口说明
证件照制作API用于帮助开发者在系统中快速完成证件照制作相关处理，返回结构化结果，适合 内容处理、自动化生产、业务集成 等场景。
适用场景
- 支持将 证件照制作 能力接入内部系统、SaaS 平台、自动化工作流或运营后台。
- 适合需要稳定调用、标准化返回和可编排接口能力的业务场景。
- 建议结合请求频控、失败重试和结果缓存策略，提升整体接入稳定性。
接入建议
- 接入前确认请求参数格式、鉴权方式和错误码处理逻辑。
- 对高频 制作 场景建议做好日志追踪、超时控制和幂等处理。
- 如结果用于风控或自动决策，建议结合业务规则进行二次判断，而不是直接单点依赖接口返回。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。
請求示例
{}響應示例
{
"code": 200,
"data": {
"size": {
"type": "array",
"items": {
"type": "string",
"example": "600"
},
"example": [
"600",
"800"
],
"description": "证件照尺寸[宽, 高]"
},
"base64": {
"type": "string",
"example": "xxxxxxxxxx"
},
"result": {
"type": "string",
"example": "xxx.jpg",
"description": "证件照图片URL。有效期1天，请尽快下载保存"
}
},
"message": "success"
}響應欄位
以下欄位根據示例 JSON 自動提取，僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| code | number | 200 |
| data | object | {...} |
| data.size | object | {...} |
| data.size.type | string | array |
| data.size.description | string | 证件照尺寸[宽, 高] |
| data.base64 | object | {...} |
| data.base64.type | string | string |
| data.base64.example |