ニフクラmBaaSお役立ちブログ

スマホアプリ開発にニフクラmBaaS。アプリ開発に役立つ情報をおとどけ!

プッシュ通知でのエラーメッセージについて

プッシュ通知を送っていて、何らかのエラーが発生することがあります。

エラーメッセージだけ見ても実際の対応をどうすべきかは分かりづらいかも知れません。そこでチェックして欲しいのがREST API リファレンス : エラーコード一覧 | ニフティクラウド mobile backendのページです。

このページではmBaaS自体のエラーはもちろん、APNsやGCMにおけるエラーメッセージについても掲載しています。例えばGCMについては執筆時点で下記のようなエラーパターンがあります。

メッセージ 意味
missingRegistration (GCM) 端末ID欠如
invalidRegistration (GCM) 不正な端末ID
notRegistered (GCM) 未登録端末ID
invalidPackageName (GCM) 不正なパッケージ名
mismatchSenderId (GCM) 誤った送信元ID
messageTooBig (GCM) メッセージ過大
invalidDataKey (GCM) 不正なデータキー
invalidTtl (GCM) 不正な有効期限
timeout (GCM) タイムアウト
internalServerError (GCM) サーバエラー
topicsMessageRateExeeded (GCM) 過剰なトピックメッセージ
invalidJson (GCM) 不正なJSON
authenticationError (GCM) 認証エラー

同様に、APNsの場合は次のようなエラーがあります。

メッセージ 意味
systemError システムエラーが発生した端末数
noErrorsEncountered (APNS) エラー無し
invalidToken (APNS) 不正なトークン
processingError (APNS) 処理エラー
missingDeviceToken (APNS) デバイストークン欠如
missingTopic (APNS) トピック欠如
missingPayload (APNS) ペイロード欠如
invalidTokenSize (APNS) 不正なトークンサイズ
invalidTopicSize (APNS) 不正なトピックサイズ
invalidPayloadSize (APNS) 不正なペイロードサイズ
invalidToken (APNS)不正なトークン
shutdown (APNS) 停止
handShakeFail (APNS)証明書に問題あり
none (APNS) 不明

このメッセージは追加されることがあります。ただ、多くの場合invalidTokenが多いようです。この場合、開発時の証明書で取得したトークンが混ざっているケースが殆どのようです。handShakeFailは証明書に問題があったり、有効期限切れというケースが多いようです。

もしエラーが起こった際にはREST API リファレンス : エラーコード一覧 | ニフティクラウド mobile backendを参照してください。