使用AWS EventBridge订阅Shopify Webhook遇ARN client_id不匹配错误求助

问题场景 #

通过Postman调用Shopify GraphQL API（端点：https://{{shopifyDevelopmentStoreName}}.myshopify.com/admin/api/2022-07/graphql.json）创建PRODUCTS_CREATE主题的EventBridge Webhook订阅时，请求ARN中使用了client_id_x，但返回错误提示需使用client_id_y，疑惑为何不使用AWS EventBridge事件总线的client_id。

请求与响应详情 #

GraphQL请求体

mutation createWebhookSubscription($topic: WebhookSubscriptionTopic!, $webhookSubscription: EventBridgeWebhookSubscriptionInput!) {
  eventBridgeWebhookSubscriptionCreate(
    topic: $topic,
    webhookSubscription: $webhookSubscription
  ) {
    webhookSubscription {
      id
    }
    userErrors {
      message
    }
  }
}

请求Payload

{
  "topic": "PRODUCTS_CREATE",
  "webhookSubscription": {
    "arn": "arn:aws:events:us-east-1::event-source/aws.partner/shopify.com/client_id_x/LovecraftEventBridgeSource",
    "format": "JSON",
    "includeFields": "id"
  }
}

错误响应

{
    "data": {
        "eventBridgeWebhookSubscriptionCreate": {
            "webhookSubscription": null,
            "userErrors": [
                {
                    "message": "Address is invalid"
                },
                {
                    "message": "Address is an AWS ARN and includes api_client_id 'client_id_x' instead of 'client_id_y'"
                }
            ]
        }
    },
    "extensions": {
        "cost": {
            "requestedQueryCost": 10,
            "actualQueryCost": 10,
            "throttleStatus": {
                "maximumAvailable": 1000.0,
                "currentlyAvailable": 990,
                "restoreRate": 50.0
            }
        }
    }
}

原因解释 #

Shopify要求ARN中填写的client_id并非AWS EventBridge事件总线的标识，而是你当前使用的Shopify应用的API密钥（即错误提示中的client_id_y）。

这是因为Shopify的EventBridge Webhook订阅是与特定Shopify应用绑定的，该client_id是Shopify分配给你的应用的唯一标识，用于验证订阅请求的合法性——确保此Webhook是由已在Shopify后台注册的正规应用发起，而非未授权的请求。

解决步骤 #

1. 登录Shopify后台，进入你正在使用的目标应用的设置页面；
2. 在页面的「API credentials」（API凭证）区域，找到并复制API key（此即为错误提示中的client_id_y）；
3. 修改请求Payload中的ARN，将client_id_x替换为复制到的API key；
4. 重新发起GraphQL请求即可完成订阅创建。

内容的提问来源于stack exchange，提问作者Michael P.