用途:为开发与集成 Tumblr API 提供实用指引,覆盖认证、博客数据、帖子、点赞、关注者、队列与草稿等操作,并帮助排查 API 请求与响应问题。
主要能力:可查询博客信息、帖子、头像与标签过滤;获取点赞与关注者;处理队列排序;创建与管理帖子;支持旧版帖子类型与 Neue Post Format(NPF,加 npf=true);包含 OAuth 1.0a 与 OAuth 2.0 认证指引、错误处理与分页模式。
使用方式:公开端点可用 api_key 查询参数,如 curl -H 'User-Agent: MyApp/1.0' 'https://api.tumblr.com/v2/blog/staff.tumblr.com/info?api_key=YOUR_API_KEY';需用户数据的端点用 Authorization: Bearer TOKEN。OAuth 2.0 授权码换令牌:curl -X POST https://api.tumblr.com/v2/oauth2/token -F grant_type=authorization_code -F code=YOUR_AUTH_CODE -F client_id=YOUR_CONSUMER_KEY -F client_secret=YOUR_CONSUMER_SECRET。请求必须带一致 User-Agent;博客标识支持名称、主机名与 UUID(推荐 UUID);响应结构含 meta 与 response。
适用场景:构建 Tumblr 客户端、仪表盘工具、分析应用,或做数据抓取与集成。
限制:速率限制按 IP 为 300 次/分钟、18000 次/小时、432000 次/天,按 Consumer Key 为 1000 次/小时、5000 次/天;动作限制为每日 250 帖、200 关注、1000 点赞。帖子 ID 为 64 位整数,JavaScript 宜用 id_string。需处理 401/404/429/503 等状态码。文档未提供具体收费与价格信息。