# IP 中台开发者文档

> 面向第三方应用开发者和代码代理的官方接入入口。OpenAPI 是 HTTP 契约真源；实时模型 Markdown 是模型可用性与调用说明真源；开发者指南解释完整业务流程和安全边界。

## 建议读取顺序

- [单文件完整文档](http://127.0.0.1:5175/llms-full.txt)：包含接入决策、开发者指南、完整 OpenAPI 和所有可运行示例。
- [OpenAPI 3.1 契约](http://127.0.0.1:5175/openapi.json)：路径、方法、字段、鉴权方式与响应结构的机器可读真源。
- [实时模型 Markdown 索引](http://127.0.0.1:5175/v1/platform/models/documentation)：从当前后台配置实时生成，包含逐模型 Markdown 链接。
- [实时模型 JSON 索引](http://127.0.0.1:5175/v1/platform/models)：需要程序消费模型元数据时使用。
- [实时模型价格](http://127.0.0.1:5175/v1/platform/models/pricing)：读取默认积分价与当前积分汇率。
- [开发者安全接入指南](http://127.0.0.1:5175/developer-integration-guide.md)：OAuth、会员、积分、支付归因、Webhook 和错误处理。

## 可视化文档

- [文档中心](http://127.0.0.1:5175/docs)
- [模型列表](http://127.0.0.1:5175/docs/models)
- [模型价格](http://127.0.0.1:5175/docs/models/pricing)
- [积分充值接入](http://127.0.0.1:5175/docs/billing/recharge)
- [会员升级接入](http://127.0.0.1:5175/docs/billing/membership)

## 示例源码

- [api-key-model-invoke.mjs](http://127.0.0.1:5175/examples/api-key-model-invoke.mjs)
- [idp-client.mjs](http://127.0.0.1:5175/examples/idp-client.mjs)
- [model-invoke.mjs](http://127.0.0.1:5175/examples/model-invoke.mjs)
- [oauth-pkce.mjs](http://127.0.0.1:5175/examples/oauth-pkce.mjs)

## 读取规则

- 不要猜测或自造接口；字段冲突时以 OpenAPI 为准。
- 不要保存模型静态白名单；通过实时模型索引获得当前可用的 `model_key`。
- 第三方应用只能读取当前授权用户，平台没有全量会员、跨应用用户或支付入口列表接口。
- 浏览器登录必须跳转平台 `/oauth/authorize` 页面；第三方应用不得收集平台密码或代替平台记录隐私同意。
- API Key、Client Secret、Access Token 只保存在应用服务端，不得写入前端、URL、日志或源码。