Miro OAuth API返回401无效授权码，无法换取Access Token

核心排查点 #

• 确认请求格式完全合规

  • 必须使用POST请求，Content-Type固定为application/x-www-form-urlencoded，不能用JSON格式提交
  • 表单参数需完整包含：grant_type=authorization_code、client_id、client_secret、code、redirect_uri，缺一不可
  • redirect_uri必须与Miro开发者平台注册应用时填写的内容完全匹配，包括协议（http/https）、域名、路径，哪怕多一个斜杠都会触发验证失败

• 核对凭据准确性

  • client_id和client_secret直接从Miro应用详情页复制，避免手动输入时出现拼写错误，尤其是secret包含特殊字符的情况
  • 授权码code仅可使用一次，用过即失效，需重新走授权流程获取新的code

• 检查授权码时效性

  • Miro授权码有效期极短（通常数分钟），若获取后间隔过久才发起换token请求，code大概率已过期，需重新生成

• 验证应用安装状态

  • 确认你的Miro应用已在目标团队完成安装，且权限范围与授权申请时保持一致

额外验证步骤 #

1. 用curl发起请求，排除Postman等工具的配置干扰：

   curl -X POST "https://api.miro.com/v1/oauth/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=authorization_code" \
     -d "client_id=YOUR_CLIENT_ID" \
     -d "client_secret=YOUR_CLIENT_SECRET" \
     -d "code=YOUR_AUTH_CODE" \
     -d "redirect_uri=YOUR_REDIRECT_URI"
   

2. 查看Miro开发者平台的应用日志（应用详情页Logs板块），获取更具体的错误提示

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