REST API プッシュAPI
最終更新日 2015-9-8

レジストレーションを削除する

レジストレーション ID 削除 API

登録した Android のレジストレーション ID を削除します。
レジストレーション ID は単体、または複数を指定することができます。

基本仕様

API 仕様

項目 説明
エンドポイント https://api-datastore.appiaries.com/v1/push/gcm/{contractId}/{applicationId}/_target
エンドポイントのパラメータ {contractId}:契約者ID
{applicationId}:アプリケーションID
メソッド DELETE (POST の場合は proc=delete を指定)
リクエストコンテントタイプ 指定なし
レスポンスコンテントタイプ application/json
制約事項

ヘッダーパラメータ

パラメータ名 項目名 タイプ 必須 説明
Content-Type application/json コンテントタイプ 文字列
X-Appiaries-Token Appiariesトークン 文字列 アプリトークン

クエリーパラメータ

パラメータ名 項目名 タイプ 必須 説明
access_token アクセストークン 文字列
proc delete PUT メソッド代替 文字列 ※説明参照 ※HTTPメソッドが POST の場合は必須

ボディパラメータ

パラメータ名 項目名 タイプ 必須 説明
regid レジストレーション ID 文字列
attr 端末属性 文字列 ・自由に設定できるデータ領域です。
・配信予約を登録するとき、ここに設定した値で配信対象を絞り込むことができます。

返却値

返却値: レスポンスヘッダ
ヘッダー
Content-Type application/json
返却値: レスポンスボディ

複数のレジストレーション ID を指定したときのみ、成功時、以下が返却されます。

パラメータ名 項目名 タイプ 説明
_count 削除総数件数 int
_failed 削除失敗件数 int

例:

返却値: レスポンスステータス
ステータスコード 説明
204 成功
400 コンテント未指定。コンテント形式不適切。
401 トークン未指定。認証失敗。
403 アプリにアクセスする権限がない。コレクションに create 権限がない。コレクションに格納可能なオブジェクトが”JSONデータ”ではない。
422 コンテント値不適切
500 予期せぬエラー発生

ステータスコード 409 または 422 のとき、JSON 形式による次のようなコンテントボディが返却されます。

エラーコード一覧

エラーコード 分類 内容
0080001 コンテント全般 コンテント不足
0080002 コンテント全般 コンテント名不適切
0080201 レジストレーションID null, 空白
0080202 レジストレーションID 文字列ではない
0080203 レジストレーションID LF, CR, TABを除く制御文字が含まれている。
0080103 attr LF, CR, TABを除く制御文字が含まれている。

curl のリクエスト例

リクエストコマンドの例

list.json の中身:

単一のレジストレーション ID を削除する場合

複数のレジストレーション ID を削除する場合