如何在Postman中正确调用iTunes Reporter API获取销售报告？

关键参数传递规则 #

别踩参数格式的坑，这是400错误的重灾区：

请求头必须配对 #

• 加Authorization头：格式是Bearer 你的access_token，注意Bearer后面有个空格，别漏
• 把Content-Type设为application/json，不然接口不认你的请求体

请求体（Body）的正确写法 #

POST的Body必须是JSON格式，重点是**queryInput里的command是个字符串，不是JSON对象**！正确格式是用空格分隔键值对，比如：

{
  "queryInput": "vendor=你的供应商编号 reportType=Sales reportSubType=Summary dateType=Monthly date=2024-05"
}

常见错误排查 #

• 别把command写成JSON对象，比如下面这种写法直接触发400：

  {
    "queryInput": {
      "vendor": "123456",
      "reportType": "Sales"
    }
  }
  

• 核对vendor_number：必须是App Store Connect里绑定你的账号的有效供应商编号
• 参数取值要符合苹果要求：
  • reportType可选Sales、Subscription等
  • reportSubType要和reportType对应，比如Sales对应Summary或Detailed
  • dateType选Daily/Weekly/Monthly/Yearly，date格式要匹配（Monthly是YYYY-MM，Daily是YYYY-MM-DD）
• 检查access_token：确保没过期，且有权限访问该供应商的报表

Postman实操步骤 #

1. 新建POST请求，URL填https://reportingitc-reporter.apple.com/reportservice/sales/v1
2. 切到Headers标签，加两个键值对：
   • Key: Authorization，Value: Bearer 你的access_token
   • Key: Content-Type，Value: application/json
3. 切到Body标签，选raw，格式选JSON，粘贴正确的请求体
4. 点发送，参数没问题的话就能拿到报表数据了

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