Bucket の確認
ある Bucket が既に作成されているか確認できます。
確認方法は以下のとおりです。
アプリケーションスコープの Bucket
curl -v -X HEAD \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
"https://api-jp.kii.com/api/apps/{APP_ID}/buckets/{BUCKET_ID}"
グループスコープの Bucket
curl -v -X HEAD \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
"https://api-jp.kii.com/api/apps/{APP_ID}/groups/{GROUP_ID}/buckets/{BUCKET_ID}"
ユーザースコープの Bucket
curl -v -X HEAD \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
"https://api-jp.kii.com/api/apps/{APP_ID}/users/me/buckets/{BUCKET_ID}"
Thing スコープの Bucket
curl -v -X HEAD \
-H "Authorization: Bearer {ACCESS_TOKEN}" \
"https://api-jp.kii.com/api/apps/{APP_ID}/things/{THING_ID}/buckets/{BUCKET_ID}"
いずれの場合も、Kii Cloud は以下の応答を返します。
- Bucket が存在する場合は 204 応答
- Bucket が存在しない場合は 404 応答
- 対象スコープに対するアクセス権限がない場合は 401 応答