概览

教程按"我想做什么"组织,与按资源组织的 API 参考 互补。每篇 教程都以一个明确的开发者目标开头(例如"让我的 SaaS 用户用 AppForges 账号 登录"),逐步走到可运行的代码。

主题分类

  • 鉴权 — User / Org 身份与 OAuth / API Key 凭证的选型
  • Webhook — 注册订阅、原始 body 签名校验与协议边界
  • 错误处理与重试 — 统一错误模型、何时该重试、X-Idempotency-Key 用法
  • 版本与升级 — /v1/ + X-AppForges-Api-Version 请求头与生效版本

推荐阅读路径

第一次接入:

  1. 快速开始 — 5 分钟跑通第一个 API 调用
  2. 选择鉴权方式 — 选定身份类型
  3. 错误处理与重试 — 写得稳的客户端
  4. 版本与升级 — 升级不踩坑

所有教程

OAuth 总览
/guides/authentication/oauth/overview
创建应用与 OAuth client
/guides/console/creating-oauth-app
用户与组织身份
/guides/identities/user-vs-org
申请权限
/guides/authorization/requesting-scopes
鉴权总览
/guides/authentication/overview
API Key 管理
/guides/console/api-key-management
Authorization Code + PKCE
/guides/authentication/oauth/authorization-code
权限目录
/guides/authorization/scopes-catalog
身份兼容性
/guides/identities/identity-compatibility
选择鉴权方式
/guides/authentication/choose-your-auth
错误处理与重试
/guides/errors-and-retries
Client Credentials
/guides/authentication/oauth/client-credentials
OAuth client secret 轮换
/guides/console/client-secret-rotation
Token 与身份
/guides/identities/token-claims
快速开始:用户 OAuth
/guides/authentication/oauth-quickstart-server-side
敏感权限
/guides/authorization/sensitive-scopes
版本与升级
/guides/versioning-and-upgrades
小文件上传编码
/guides/uploads
API Key 鉴权
/guides/authentication/api-key
Refresh Token
/guides/authentication/oauth/refresh-token
Webhooks
/guides/webhooks
用户授权页面
/guides/authorization/consent-screen
管理 redirect URI
/guides/console/managing-redirect-uris
Token Introspection
/guides/authentication/oauth/token-introspection
Webhook 签名验证
/guides/authentication/webhooks-signing
Webhook 管理
/guides/console/webhook-management
Token 撤销
/guides/authentication/oauth/token-revocation
应用成员管理
/guides/console/managing-organization-members