概要
サービスの契約プランの更新が完了するとSquareProvisioning WebHookが発行されます。
（スクエアへのaction属性は「UPDATE」として発行されます）
SquareProvisioning WebHookには、契約された料金プランの情報と契約によって生成されたスクエアのIDが含まれます。
基本プランが更新された場合、action属性として「UPDATE」が設定されます。（「ADD」または「DELETE」が設定されることはありません）
オプションプランが追加／削除された場合は、action属性としてそれぞれ「ADD」または「DELETE」が設定されます。
WebHookとして送信される料金プランの情報は、差分のみになります。そのため更新がなされない料金プランに関しては発行されるデータに含まれません。
リクエストボディ
以下のJSONフォーマットでCloudGearからCloudGearアプリケーションにHTTPリクエストが送信されます。
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"event":"squareprovisioning",
"data": [{
"plans": [{
"id":"UUID1", // プランID
"action":"UPDATE" // プランへの操作タイプ
},
{
"id":"UUID2", // プランID
"action":"ADD" // プランへの操作タイプ
},
{
"id":"UUID3", // プランID
"action":"DELETE" // プランへの操作タイプ
}],
"squareId":"UUID", // スクエアID
"serviceId":1, //サービスID
"action":"UPDATE", // スクエアへの操作タイプ
"cause":"update plans." // 操作理由
"userinfo":{ // スクエアオーナーのユーザー情報
"sub":"cloudgear@cloudgear.services",
"name":"クラウドギア",
"email":"cloudgear@cloudgear.services",
"given_name":"ギア",
"family_name":"クラウド",
"preferred_username":"cloudgear@cloudgear.services",
"square_id":"UUID",
"square_attrs":{
"属性名":"属性値",
...
}
}]
} |