PassportCraft API 文档

从您自己的系统中创建、更新并发布数字产品护照。每个端点都归属于单个组织，密钥也只能看到已获授权的那些组织。

API 版本: 2026-08-01
基础 URL: https://passportcraft.com/api/v1
OpenAPI 3.1.0 文档: openapi.json
端点数量: 26

路径、方法、作用域、字段名和错误码一律以英文发布，因为接口本身的语言就是英文——这些正是调用方需要照原样输入或比对的内容。每一段代码示例、每一个 JSON 载荷，以及错误响应中携带的那句原文，同样如此：/v1 不读取 Accept-Language，把 API 实际发送的内容翻译出来反而会造成误述。围绕它们的说明文字则跟随本页面的语言。

从这里开始

快速开始创建密钥、发出第一个调用，然后创建并发布一份护照。身份验证密钥如何随请求发送、测试与正式环境如何保持隔离，以及每个端点要求哪一个作用域。通用约定幂等性、分页、条件写入，以及处处适用的各项限额。错误每一次拒绝都带有稳定的错误码。全部 35 个错误码连同其 HTTP 状态码都在此列出。

接口参考

每类资源一个页面。每个端点都写明所需作用域、参数、请求体、一份响应示例，以及它可能返回的拒绝。