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

配信予約を更新する

指定日時予約更新 API

予約されたプッシュ配信の内容を更新します。
デバイスの内容は更新できません。

基本仕様

API 仕様

項目 説明
エンドポイント https://api-datastore.appiaries.com/v1/push/manage/{contractId}/{applicationId}/{reserveId}
エンドポイントのパラメータ {contractId}:契約者ID
{applicationId}:アプリケーションID
{reserveId}:配信予約ID
メソッド PUT
リクエストコンテントタイプ application/json
レスポンスコンテントタイプ application/json
制約事項 ・{reserveId} に該当するデータがない場合は更新できません。
・すでに配信されている場合は更新できません。
・デバイスの内容は更新できません。
・日付指定せずに更新した場合は、即時配信となります。

ヘッダーパラメータ

パラメータ名 項目名 タイプ 必須 説明
X-Appiaries-Token Appiariesトークン 文字列 アプリトークン

クエリーパラメータ

パラメータ名 項目名 必須 備考
proc put PUT メソッド代替 ※説明参照 ※HTTPメソッドが POST の場合は必須
proc payload ペイロードサイズ返却 更新は行わず、ペイロードサイズのみを返却する

ボディパラメータ

ボディパラメータ: GCM
パラメータ名 パラメータ名(子) 項目名 タイプ 必須 説明
reserve_datetime 送信予約日時 文字列 ・送信日時を下記の形式で指定します。
yyyy-MM-ddTHH:mm+0900(ISO8601)
・指定がない場合、即時配信となります。
・未来日時は1ヶ月先まで指定できます。
・過去日時は指定できません。
gcm gcm オブジェクト GCMパラメータ定義開始ポイント
data 通知データ オブジェクト ・アプリケーションが利用するパラメータを設定します。
・基本書式は「{“aa”:”bb”}」となり、「””」による文字列指定となります。
・「{}」内は1階層のみ許可されます。
・文字列以外が指定された場合、予期せぬ変換が行われるため、必ず「””」で囲って下さい。
collapse_key グループ折畳メッセージ 文字列 ・パラメータ「time_to_live」指定時は必須となります。
・折畳メッセージ文字列を指定します。
delay_while_idle アイドル時送信の有効/無効 Boolean ・アイドル送信の有効/無効を設定します。
・true:有効
・false:無効
time_to_live メッセージ保存時間 Int ・パラメータ「collapse_key」指定時は必須となります。
・メッセージの保存時間を指定します。
api_key GCM API KEY 文字列 ※説明参照 ・GCMのAPIキーを設定します。
※ユーザ管理画面のマーケット設定に API キーが登録されている場合、本パラメータを省略することができます。
ボディパラメータ: APNs
パラメータ名 パラメータ名(子) 項目名 タイプ 必須 説明
reserve_datetime 送信予約日時 文字列 ・送信日時を下記の形式で指定します。
yyyy-MM-ddTHH:mm+0900(ISO8601)
・指定がない場合、即時配信となります。
・未来日時は1ヶ月先まで指定できます。
・過去日時は指定できません。
apns APNs オブジェクト APNsパラメータ定義開始ポイント
alert 通知 オブジェクト 通知メッセージ定義開始ポイント
body 通知メッセージ 文字列 ・通知センターの表示メッセージを設定します。
badge バッヂ Int ・ホーム画面上のアイコンの右上に表示される数値を設定します。
・0以下の値が設定されると数値表示がクリアされます。
sound 通知音声 文字列 ・通知センターがプッシュ通知を受取った際に鳴らすサウンドを設定します。
・アプリケーションバンドルに含まれるサウンドを設定します。
・アプリケーションがフォアグラウンドで動作している状態で直接プッシュ通知を受取った場合、サウンドは鳴りません。
content_available バックグラウンド起動フラグ Int ・iOS7以降、バックグラウンド通知を受取るか指定します。
・アプリケーションがフォアグラウンドで起動していない場合、直接アプリケーションが受け取ります。
・0=フロント起動
・1=バックグラウンド起動

(Apple 提供ガイドラインからの抜粋)

content-availableプロパティの値が1であれば、リモート通知は「無言の」通知として振る舞います。無言の通知が届くと、iOSはアプリケーションをバックグラウンドで「起こし」て、サーバから新規データを取得したり、バックグラウンドで情報を処理したりできるようにします。ユーザは、この時点では新しい情報や変化した情報を何も知らされませんが、次にアプリケーションを開いた時点で知ることができます。

custom_data カスタムデータ オブジェクト ・アプリケーションが利用するパラメータを設定します。
・プッシュメッセージ全体のペイロードサイズは下記に制限されます。
iOS7以前:最大256バイト
iOS8以降:最大2048バイト
・基本書式は「{“aa”:”bb”}」となり、「””」による文字列指定となります。
・「{}」内は1階層のみ許可されます。
・文字列以外が指定された場合、予期せぬ変換が行われるため、必ず「””」で囲って下さい。
p12cert APNs証明書
(p12証明書)
文字列 ※説明参照 ・APNs証明書をBASE64(パディングなし)形式へ変換した文字列を設定します。
・APNs証明書のBASE64の変換手順は「9.APNsのp12証明書をBase64へ変換する手順」を参照して下さい。
※ユーザ管理画面のマーケット設定に、「証明書」が登録されている場合、本パラメータを省略することができます。
・ユーザ管理画面へ設定するAPNs証明書はBASE64へ変換する必要はありません。
password APNs証明書のパスワード 文字列 ※説明参照 ・APNs証明書のパスワードを設定します。
※ユーザ管理画面のマーケット設定に、「パスワード」が登録されている場合、本パラメータを省略することができます。
production プッシュ送信先環境 Boolean ・プッシュ送信先の環境を設定します。
・true:本番環境
・false:サンドボックス環境

返却値

返却値: コンテントボディ

正常に予約登録が完了した場合の返却値を下記に説明します。

パラメータ名 項目名 タイプ 説明
_id 送信予約ID 文字列 ・予約IDを返却します。
payload_length 送信ペイロード長 Int ・送信メッセージのペイロード長を返却します。
返却値: レスポンスステータス

REST APIのレスポンスステータスを下記に説明します。

ステータスコード 説明
200 正常に処理が終了しました。
400 不正なリクエスト内容が送信されました。
401 アプリトークンが未指定、又は、認証に失敗しました。
403 指定されたIDにアセス権限がありません。
404 指定されたIDに該当するデータがありません。
412 マーケット設定が行われていません。
422 以下の何れかの誤りがあります。
・devices または device_search_conditions が指定されています。
・登録したときの配信デバイス種別と同一ではありません。
・すでに配信された配信予約です。
・オプション「apns」「gcm」の両方が指定されています。
・オプション「reserve_datetime」に過去日時が指定されています。
・オプション「reserve_datetime」に1ヶ月以上先の日時が指定されています。
css_use または sender_id が指定されています。
500 アピアリーズサーバに於いて、エラーが発生しました。

REST API のリクエスト例

REST API リクエスト例: GCM

項目
リクエスト先のエンドポイント https://api-datastore.appiaries.com/v1/push/manage/{contractId}/{applicationId}/{reserveId}
メソッド PUT
コンテントタイプ application/json
ヘッダーパラメータ X-Appiaries-Token: {アプリトークン}

ボディパラメータ

REST API リクエスト例: APNs

項目
リクエスト先のエンドポイント https://api-datastore.appiaries.com/v1/push/manage/{contractId}/{applicationId}/{reserveId}
メソッド PUT
コンテントタイプ application/json
ヘッダーパラメータ X-Appiaries-Token: {アプリトークン}

ボディパラメータ

curl のリクエスト例

curl コマンド例: GCM

リクエストコマンドの例

返却値の例

返却値の例:異常(1):パラメータエラー発生

※エラー番号一覧は「エラーコード一覧」を参照して下さい。

返却値の例:異常(2):パラメータエラー発生

※エラー番号一覧は「エラーコード一覧」を参照して下さい。

curl コマンド例: APNs

リクエストコマンドの例

返却値の例

返却値の例:異常(1):パラメータエラー発生

※エラー番号一覧は「エラーコード一覧」を参照して下さい。

返却値の例:異常(2):パラメータエラー発生

※エラー番号一覧は「エラーコード一覧」を参照して下さい。