开发者中心

从注册插件到上架，全流程走接口完成。下面四步是最短路径。

三条身份通道

协议	入口	适用场景	限制
HTTP / REST	`/api/plugins/{code}/...`	插件开发主通道	统一 {code,message,data}
JSON-RPC 2.0	`POST /api/rpc`	脚本与批量调用	8 个平台方法，支持批量
MCP	`POST /api/mcp`	AI / Agent 工具接入	8 个工具，initialize→tools/list→tools/call
ConnectRPC	`POST /connect/cfapi.v1.{S}/{M}`	强类型 RPC	3 服务 5 方法，json/proto 双 codec
gRPC（原生）	`—`	—	不支持二进制帧与 trailers
gRPC-Web(JSON)	`POST /api/grpc/{s}/{m}`	调试兼容	JSON 封装，非二进制
GraphQL	`POST /api/graphql`	多字段一次取	12 字段，偏管理面
WebSocket	`GET /ws?token=`	实时系统事件	需 JWT；全站订阅限内部层级
SSE	`GET /api/events`	轻量事件流	仅 system_event / error
Webhook	`/api/plugins/{code}/hooks`	插件事件回调首选	带投递记录与重试
OpenAPI	`GET /api/openapi.json`	生成 SDK	OpenAPI 3.1.0
OAuth2	`POST /api/oauth/token`	终端用户授权	授权码流程
OIDC	`/api/oauth/.well-known/...`	发现 + JWKS	可自行验签用户令牌
JWT	`Authorization: Bearer`	用户身份	EdDSA(Ed25519)
APIKey	`Authorization: Bearer`	服务端到服务端	内部/外部两级，外部最小权限
AdminAPI	`/api/admin/*`	平台管理	需管理员，不是插件接口
MetricsAPI	`GET /metrics`	Prometheus 抓取	运维面
HealthCheck	`GET /api/health`	探活	运维面
CLI	`scripts/cfapi-cli.sh`	运维脚本	不是插件接口
SAML2	`/api/saml/*`	企业单点登录	需 IdP 配置