Amazon Ads Token Broker

Multi-account token management service.

Endpoints:

• POST /amazon-ads/tokens — Register/update an account (Bearer auth)
• GET /amazon-ads/tokens — List all accounts (Bearer auth)
• GET /amazon-ads/access-token?brand=X®ion=Y&name=Z — Get access token (Bearer auth)
• GET /authorize?brand=X®ion=Y&name=Z — Start OAuth flow for an account
• GET /callback — OAuth callback (automatic)
• API Documentation (Swagger UI)

Regional Endpoints (base_endpoint)

注册账户时必须指定 base_endpoint，用于标识该账户对应的 Amazon Ads API 区域端点：

• 北美: https://advertising-api.amazon.com
• 欧洲: https://advertising-api-eu.amazon.com
• 远东: https://advertising-api-fe.amazon.com

示例：注册账户

curl -X POST /amazon-ads/tokens \
  -H "Authorization: Bearer YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-account",
    "brand": "MyBrand",
    "region": "NA",
    "base_endpoint": "https://advertising-api.amazon.com",
    "client_id": "amzn1.application-oa2-client.xxx",
    "client_secret": "xxx",
    "refresh_token": "xxx"
  }'

示例：获取 access token

curl "/amazon-ads/access-token?name=my-account" \
  -H "Authorization: Bearer YOUR_SECRET"

响应中将包含 base_endpoint，调用方可直接用于构造 Amazon Ads API 请求 URL。