衣同GSD标准工时系统 · 系统集成与API对接能力说明
一、写在前面（重要）
本文是衣同GSD标准工时系统对外公开的能力说明与对接范式，用于帮助客户快速了解"我们能不能对接、对接长什么样"。
本文档使用的所有地址、凭证均为示例，不包含任何真实的接口地址、账号密码或技术细节。 真实的接口路径、访问凭证、字段映射等技术资料，将由我方技术团队在正式签约对接后，通过加密渠道单独交付，并协助联调。
二、我们支持哪些对接？
衣同GSD标准工时系统与衣同智能化服装工厂数字化方案，对外提供 HTTPS + JSON 格式的标准接口能力，覆盖以下场景：
| 能力域 | 说明 | 典型用途 |
|---|---|---|
| 工艺数据查询 | 查询款式的工序、工时、工价等标准数据 | ERP读取工时用于成本核算 |
| 现场数据采集 | 车间平板/手机端数据上报 | MES同步生产进度 |
| AI 智能识别 | 部件图片识别与工序推荐 | 辅助新款快速建工艺 |
| 智能产线编排 | 基于工时的工位排布与平衡优化 | 排产系统调用 |
| 主数据同步 | 款式、员工、部门等基础数据 | 各系统主数据统一 |
> 以上为能力域概览，具体每个能力下包含哪些接口、如何调用，需在对接阶段详谈。
三、对接范式（示例，非真实接口）
为帮助客户的技术团队评估对接可行性，下面给出一个通用范式。请注意：以下示例地址 `api.example.com` 为国际通用的文档演示域名，并非我方真实服务器，仅用于说明调用结构。
范式一：查询类接口（以"查询某款式工序"为例）
请求：
```
GET https://api.example.com/v1/styles/S001/operations
请求头：Authorization: Bearer <您的对接凭证>
```
响应（示意）：
```json
{
"code": 0,
"message": "ok",
"data": [
{
"序号": "001",
"工序名称": "锁边",
"标准工时": "25.5",
"工价": "0.35",
"其他业务字段": "..."
}
],
"分页信息": { "页码": 1, "总数": 35 }
}
```
范式二：上传类接口（以"现场图片上报"为例）
请求：
```
POST https://api.example.com/v1/photo-sessions
请求头：Authorization: Bearer <您的对接凭证>
请求体：业务数据（JSON）
```
响应（示意）：
```json
{
"code": 0,
"message": "ok",
"data": { "会话标识": "sess_abc123", "状态": "已创建" }
}
```
通用约定（示意）
| 约定项 | 说明 |
|---|---|
| 传输协议 | HTTPS（生产环境强制） |
| 数据格式 | JSON，UTF-8 编码 |
| 鉴权方式 | Bearer Token（对接凭证由我方分配） |
| 频率限制 | 有合理限流，防止滥用 |
| 错误处理 | 统一错误码体系，便于排查 |
四、对接流程
为保证安全与质量，我们采用标准化对接流程：
1. 需求确认：明确对接场景、数据范围、调用频率
2. 开通专用凭证：为每个客户分配独立、最小权限的对接凭证
3. 交付真实文档：通过加密渠道提供完整接口文档（含真实路径、字段、示例）
4. 联调测试：我方技术团队协助客户在测试环境联调
5. 上线运维：正式上线后持续提供技术支持
五、安全保障承诺
我们高度重视数据安全，对接过程遵循以下原则：
- 最小权限：为客户开通的凭证仅具备必要权限，可按工厂/模块隔离
- 传输加密：生产环境全链路 HTTPS
- 凭证隔离：每个客户独立凭证，互不影响；可随时吊销
- 不含敏感信息：公开文档不泄露服务器架构、数据库结构、内部实现
- 可审计：接口调用有日志记录，便于追溯
六、想对接？联系我们
如果您有系统集成需求，欢迎联系我们。我们的技术团队会：
- 评估您的对接场景
- 提供定制化对接方案
- 分配专用凭证并协助联调
> 本文仅为能力概览与范式（示例地址 api.example.com 仅为演示用）。真实接口的技术细节，将在签约对接后由我方技术人员单独交付，确保您的数据安全与系统稳定。