# Watcha OAUTH

> 观猹（Watcha）OAuth2.0 接入指南。用于帮助开发者完成观猹 Authorization Code 授权流程，包括客户端申请、授权页跳转、Token 换取、用户信息获取、Token 刷新与校验。适用于 Web 应用、移动 App 等场景，支持 PKCE 扩展。

- Skill: `lstm-kirigaya/watcha-oauth` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add lstm-kirigaya/watcha-oauth`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lstm-kirigaya/watcha-oauth/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: lstm-kirigaya (https://skillmd.com/u/lstm-kirigaya)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lstm-kirigaya/watcha-oauth

---


# 观猹 OAuth2.0 接入指南

## 快速开始

1. **申请开通**：填写申请表单并获取 `client_id` 和 `client_secret`
2. **引导授权**：将用户跳转至观猹授权页面
3. **处理回调**：在 `redirect_uri` 接收 `code`，换取 `access_token`
4. **获取用户信息**：使用 `access_token` 调用用户接口

## 参考文档

- **申请与测试**：见 [references/application.md](references/application.md) — 包含申请表单、测试环境 client_id/client_secret
- **授权流程**：见 [references/authorization-flow.md](references/authorization-flow.md) — 包含完整授权流程、Scope 说明、回调处理、错误码
- **API 参考**：见 [references/api-reference.md](references/api-reference.md) — 包含 Token 换取、刷新、校验、用户信息 API 的详细请求与响应

## 品牌物料

- **观猹小图标**：[点击下载](https://watcha.tos-cn-beijing.volces.com/products/logo/1752064513_guan-cha-insights.png?x-tos-process=image/resize,w_720/format,webp)

## 脚本工具

- **PKCE 生成**：`scripts/generate-pkce.py` — 生成 `code_verifier` 和 `code_challenge`
- **Python 完整示例**：`scripts/watcha-oauth-example.py`
- **Node.js 完整示例**：`scripts/watcha-oauth-example.js`

## 核心端点

| 用途 | 端点 |
|------|------|
| 授权页 | `GET https://watcha.cn/oauth/authorize` |
| 换取/刷新 Token | `POST https://watcha.cn/oauth/api/token` |
| 用户信息 | `GET https://watcha.cn/oauth/api/userinfo` |
| Token 校验 | `POST https://watcha.cn/oauth/api/introspect` |

## 注意事项

- `client_id` 含 `+`、`/`、`=` 等特殊字符，URL 传递时必须做 URL 编码
- 公开客户端（`is_public=true`）必须使用 PKCE
- `email` 和 `phone` 仅在申请了对应 scope 且用户同意后才返回