开放平台 API + SDK | 通过接口实现 PCB 自动下单、计价、查询与物流追踪
支持 API、SDK、Skill 三种方式：
| 方式 | 说明 | 适合 |
|---|---|---|
| API | HTTP POST + JSON，域名 https://open-api.jlc.com，HmacSHA256 签名认证 | 所有语言，灵活对接 |
| SDK | Java SDK，封装了签名/请求/响应，控制台 → 开发指南 → SDK 下载 | Java 项目，开箱即用 |
| Skill | 下单助手 skill，AI 自动引导注册→签名→调接口→排错 | 用 AI 工具（Codex / Claude）对接 |
| 步骤 | 操作 | 说明 |
|---|---|---|
| ① 注册登录 | 访问 open.jlc.com | 用嘉立创账号登录 |
| ② 创建应用 | 控制台 → 创建应用 → 申请 | 自动审核通过 即时获得 AppID / AccessKey / SecretKey |
| ③ 设置 IP 白名单 | 控制台 → 应用设置 | 填入调用方服务器公网 IP |
| ④ 充值预付款 | 嘉立创钱包 管理转入转出 | 预付款与开放平台登录账号关联（同客编），如需自动扣款支付需先充值 |
| ⑤ 调用 API / 引入 SDK / 装 Skill | API：见下方接口文档｜SDK：控制台下载｜Skill： 下载 Skill（7KB） 安装说明 | API 每个请求需签名认证，SDK 自动封装，Skill 由 AI 引导 |
点击卡片查看详情
| 问题 | 答案 |
|---|---|
| 接口支持哪些板材？ | 实测仅 FR-4（plateType=1）稳定支持；罗杰斯/铝基板/铁氟龙/FPC/铜基板暂不支持，走网页端下单 |
| 下单数量有没有限制？ | 需为标准档位（5/10/20/30/50/75/100）；同时包裹重量 ≤3kg，超重报错可减数量或换顺丰 |
| 怎么测试下单不扣钱？ | 无沙箱环境。传 advancePayment=false 下单成功不进入支付，即可测试完整链路 |
| 快递怎么传？ | 必须传编码（如 SF_DSBZ_JF），不能传名称；传名称会导致快递字段空值 |
| 有没有技术联系人接口？ | 没有。只有下单联系人 orderLinkMan 和收货人 orderReceive，技术联系人用 orderRemark 备注 |
| 怎么支付？ | 两种：① 网页手动支付；② 下单传 advancePayment=true 走预付款自动扣款（需先充值） |
| 下载工程文件要传什么？ | 必传 fileType + downloadReason，返回 OSS 签名链接，有时效 |
| 扫板上的码能查订单吗？ | 能，用序列码查询接口，返回与单条查询一致的结构 |
| 同一文件能重复下单吗？ | 不能，会提示"存在重复文件"，更换 fileName 即可 |
| 返单和创建订单字段一样吗？ | 返单更少：顶层无 pcbFileUrl/fileName/钢网/二维码，自动扣款字段是 isAdvancePayment（不是 advancePayment） |