用途：帮助开发者使用 Pinterest API v5，覆盖 OAuth 2.0 认证流程、Pin/Board 管理、用户账户信息、分析指标和常见集成模式。
主要能力：OAuth 授权 URL 生成与授权码换取访问令牌；Pin 的创建、获取、更新、删除；Board 的创建、列表及获取 Board 内 Pin；获取当前用户账户；获取 Pin 分析数据（如 IMPRESSION、SAVE、PIN_CLICK、OUTBOUND_CLICK、VIDEO_START）；错误处理与常见错误码说明；Python 与 JavaScript/Node.js 示例；分页、批量操作与限流处理思路。
必要用法：基础地址为 https://api.pinterest.com/v5/，请求需带 Authorization: Bearer {access_token}，响应为 JSON。令牌交换示例：curl -X POST https://api.pinterest.com/v5/oauth/token --header "Authorization: Basic {BASE64_ENCODED_CLIENT_CREDENTIALS}" --header "Content-Type: application/x-www-form-urlencoded" --data-urlencode "grant_type=authorization_code" --data-urlencode "code={AUTHORIZATION_CODE}" --data-urlencode "redirect_uri={REDIRECT_URI}"。常用 scope 包括 boards:read、boards:write、pins:read、pins:write、user_accounts:read、ads:read。
适用场景：实现 Pinterest 登录与授权、发布或管理 Pin 与 Board、将 Pinterest 分析与指标接入应用、构建 API 客户端或 SDK、为 Web/移动应用添加分享功能、设置企业账户与广告账户集成。
限制与注意事项：所有端点需 OAuth 2.0 认证；访问令牌 30 天过期，需用刷新令牌更新；限流按用户计，需处理 429 类错误并参考 X-RateLimit-* 响应头；企业级分析或广告功能需相应账户权限；视频 Pin 需特殊处理；部分功能需通过 Pinterest 应用审核；图片需公开可访问、大小不超过 10MB 且格式受支持。具体价格、收费与最新变更暂未提供，需查阅官方文档确认。