サーバー構築不要！スマートフォンアプリ向けの新クラウド

トップ >ドキュメント >REST API リファレンス:プッシュ通知取得

REST API リファレンス

共通ドキュメント

プッシュ通知取得

プッシュ通知取得APIについて

プッシュ通知の取得を行います。
プッシュ通知配信履歴自動バックアップ機能でバックアップされたデータを指定した場合、E404001エラーが返却されます。
配信済みのプッシュ通知データへAPIアクセスする処理を組み込まれる場合は、自動バックアップによりエラーが発生する可能性があることを考慮した実装をお願いいたします。

基本仕様

  • APIパス：/push/オブジェクトID
  • メソッド：GET

リクエストヘッダー

シグネチャやAPIキーなどの詳細は「共通フォーマット」を参照してください。

フィールド名 内容
Content-Type application/json

リクエストコンテント

なし

HTTPステータス

ステータスコード 説明
200 取得完了

レスポンスヘッダー

フィールド名 値
Content-Type application/json

レスポンスコンテント

パラメータ名 説明 データ型 必須
objectId オブジェクトID 文字列
deliveryTime 配信時刻 日付
target ターゲット 配列
searchCondition 検索条件 オブジェクト
title タイトル 文字列
message メッセージ 文字列
userSettingValue ユーザー設定値 オブジェクト
deliveryExpirationDate 配信期限日 日付
deliveryExpirationTime 配信期限時間 文字列
deliveryPlanNumber 配信予定数 数値
deliveryNumber 配信数 数値
status ステータス 数値
error エラー内容 オブジェクト
action アクション 文字列
badgeIncrementFlag バッジ数増加フラグ 真偽値
badgeSetting バッジ数 数値
sound 音楽ファイル 文字列
contentAvailable content-available 真偽値
dialog ダイアログ通知有効化フラグ 真偽値
richUrl リッチプッシュURL 文字列
category カテゴリ 文字列
createDate 登録日時 日付
updateDate 更新日時 日付
acl ACL オブジェクト
  • 配信予定数、配信数は以下の内容となりますので、二つの値が同一でない場合がございますが、問題ございません。例として、プッシュ通知の登録後からプッシュ通知の配信時刻までの間に、配信端末(installation)が新たに登録されて検索条件(searchCondition)に合致する場合や、既存の配信端末(installation)に変更があり検索条件(searchCondition)に合致するようになった・合致しなくなった場合などに、二つの値が同一でなくなります。
    • 配信予定数：プッシュ通知を登録した時点の配信予定端末数(プッシュ通知登録時点のinstallationに基づく)
    • 配信数：プッシュが実際に送信された端末数（プッシュ通知送信処理時点のinstallationに基づく）

プッシュ通知のステータスについて

数値 管理画面での表示 内容
0 未配信 APNs/FCMへの配信依頼前
1 配信中 APNs/FCMへ配信依頼中
2 配信済み APNs/FCMへ配信依頼がエラーなく完了※端末までの配信はAPNs/FCMや通信環境に依存しているため、必ず端末にプッシュ通知が届いたという訳ではありません
3 上限により中止 プランによる配信上限越えのため配信依頼未実施で終了
4 配信エラー エラーのため配信依頼未実施で終了（API キー不正、証明書不正 等）もしくは配信依頼が完了したが全てでエラー発生
5 フラグOFFのため未送信で終了 フラグOFFのため配信依頼未実施で終了 ※現在の仕様により、通常利用では発生しません
6 配信済み(一部エラー) 配信依頼が完了したが一部でエラー発生

errorフィールドについては、ステータスが「4:配信エラー」もしくは「6:送信完了だが一部送信でエラー発生」の場合に、発生したエラー詳細とエラーが発生した端末数を表示します。詳細はエラーコード一覧をご覧ください。
※例外として、APNs証明書エラーにより「4:配信エラー」になった場合、errorは空になります。

なお、配信依頼結果の成功した端末件数で、ステータス「4:配信エラー」と「6:送信完了だが一部送信でエラー発生」を区別しています。成功した端末が0件の場合、ステータスが「4:配信エラー」になり、それ以外の場合、ステータスが「6:送信完了だが一部送信でエラー発生」となります。

リクエストサンプル

curl -X GET -G \
 -H "X-NCMB-Application-Key: 549116a86b0ebbec4832d4086a56f36c82a5d64bc6528fa5e6220be76db5ef45" \
 -H "X-NCMB-Timestamp: 2013-08-14T15:46:25.543" \
 -H "X-NCMB-Signature: Emx2idk/xk0yvnTNQv+yBILy2Ftcu25hHeOvwa0cP/0=" \
 -H "Content-Type: application/json" \
https://mbaas.api.nifcloud.com/2013-09-01/push/IcdC9M0EJwn6Azef

レスポンスサンプル

{
  "objectId":"IcdC9M0EJwn6Azef",
  "deliveryTime":{
    "__type":"Date",
    "iso":"2013-09-21T04:02:00.000Z"
  },
  "target":[
    "ios",
    "android"
  ],
  "searchCondition":null,
  "message":"push test",
  "userSettingValue":null,
  "deliveryExpirationDate":null,
  "deliveryExpirationTime":null,
  "deliveryPlanNumber":1,
  "deliveryNumber":0,
  "status":0,
  "action":null,
  "badgeIncrementFlag":true,
  "sound":null,
  "contentAvailable":false,
  "title":null,
  "createDate":"2013-09-11T11:46:29.410Z",
  "updateDate":"2013-09-11T11:46:29.410Z",
  "acl":{
    "*":{
      "read":true,
      "write":true
    }
  }
}

お探しの内容が見つからなかった場合はユーザーコミュニティ もご活用ください。（回答保証はいたしかねます）
なお、 Expertプラン以上のお客様はテクニカルサポートにてご質問を承らせて頂きます。

推奨画面サイズ1024×768px以上

ページの先頭へ