使用Node.js与Twitter API添加Twitter列表成员的最简方法

最低要求授权信息 #

• 列表成员增删属于用户写操作，不支持OAuth2客户端凭证模式（即Bearer Token认证），必须使用OAuth 1.0a 用户上下文认证
• 必须凑齐4个认证参数，仅Consumer Key/Secret无法完成认证：
  • API Key（即Consumer Key）
  • API Key Secret（即Consumer Secret）
  • 对应操作账号的Access Token
  • 对应操作账号的Access Token Secret

关键注意点：开发者平台中对应应用必须开启Read/Write访问权限，权限修改后必须重新生成Access Token和Access Token Secret，旧令牌不会同步更新权限，缺权限/用旧令牌一定会返回401错误。
以上4个参数均可在Twitter开发者平台对应项目的Keys and Tokens页面直接生成，不需要额外走复杂授权流程。

最简可运行代码 #

不要用官方示例中依赖特定got版本的复杂实现，Node.js 18+版本自带原生fetch，仅需安装一个轻量签名依赖即可运行，没有版本兼容问题：

1. 初始化项目后安装唯一依赖：

   npm install oauth-1.0a
   

2. 运行代码（替换所有占位参数即可）：

   const OAuth = require('oauth-1.0a');
   const crypto = require('crypto');
   
   // 替换为自己的参数
   const CONFIG = {
     API_KEY: '替换为你的API Key',
     API_KEY_SECRET: '替换为你的API Key Secret',
     ACCESS_TOKEN: '替换为你的Access Token',
     ACCESS_TOKEN_SECRET: '替换为你的Access Token Secret',
     LIST_ID: '替换为目标列表的纯数字ID',
     TARGET_USER_ID: '替换为要添加账号的纯数字用户ID'
   };
   
   const oauth = OAuth({
     consumer: { key: CONFIG.API_KEY, secret: CONFIG.API_KEY_SECRET },
     signature_method: 'HMAC-SHA1',
     hash_function: (baseString, key) => crypto.createHmac('sha1', key).update(baseString).digest('base64')
   });
   
   async function addListMember() {
     const reqConfig = {
       url: `https://api.twitter.com/2/lists/${CONFIG.LIST_ID}/members`,
       method: 'POST',
       data: { user_id: CONFIG.TARGET_USER_ID }
     };
   
     const authHeader = oauth.toHeader(oauth.authorize(reqConfig, {
       key: CONFIG.ACCESS_TOKEN,
       secret: CONFIG.ACCESS_TOKEN_SECRET
     }));
   
     const resp = await fetch(reqConfig.url, {
       method: reqConfig.method,
       headers: {
         ...authHeader,
         'Content-Type': 'application/json'
       },
       body: JSON.stringify(reqConfig.data)
     });
   
     const result = await resp.json();
     console.log(resp.ok ? '添加成功' : '请求失败', result);
   }
   
   addListMember();
   

常见问题排查 #

• Postman调用返回401的核心原因：认证类型未选择OAuth 1.0、4个认证参数未填全、应用未开启读写权限、权限修改后未重新生成Access Token
• 所有接口参数必须使用纯数字ID，不要用@用户名、列表slug这类字符串标识，API v2不支持用这类标识发起写操作
• 批量添加成员时注意速率限制：单应用每15分钟最多可添加50个列表成员，批量操作时做好间隔控制即可解决限流问题，用列表拉取1000+账号推文的方案本身是可行的，比单独轮询每个账号的时间线省90%以上的限流额度。

内容的提问来源于stack exchange，提问作者Christoffer