共通仕様

　dodaiiはRESTベースのiPhone向けAPIを提供しています。POSTリクエストを利用し、dodaiiに登録されている情報を閲覧したり、dodaiiにトランザクション情報を保存したりすることが可能です。APIのレスポンスはjsonで返却されます。文字コードは入出力ともにUTF-8です。

共通リクエストパラメータ 

●アプリケーションID 

　全てのAPIにはアプリケーショントークンが必要です。トークンはdodaiiパネルのアプリケーション一覧のページで確認出来ます。




●udid（端末固有ID）

購入確認通知APIでは、udidパラメータをオプションとなっております。
トラブルの際の手がかりとして利用したいお客様は、UDID以外のIDをアプリなどで生成し、パラメータとして送信してください。
UDIDを利用した場合、2013年5月1日以降はAppleへの申請でリジェクトされてしまいますので、ご注意ください。　

APIバージョン
　　正式リリース後は、APIの仕様変更は原則行わず、バージョン番号による新旧使用の平行稼働を行います。旧バージョンの停止は1年以上前を目処にdodaii上にメールで告知します。
バージョン番号はAPIのURLで確認可能です。

https://dodaii.com/api/v<バージョン番号>/<メソッド名>

共通エラー
エラー時はHTTPステータスコード400または500を返却します。通常は200ですので、エラーハンドリングにご利用下さい。レスポンスにはエラーである旨とエラーIDをjsonで返却しますので、ログの収集、デバッグにご利用下さい。

 エラーケースエラーID
 必要なパラメータがない 1001
 パラメータの形式が異常・又は未登録の値 1002
 データが1件もない 1501
 データの有効期限切れ 1502
 Appleサーバと連携失敗 2001
 システム例外 5001またはなし


サンプルレスポンス（エラー） 

{"error":{"code":"1002","message":"undefined key.","requestedURI":"/api/v1/product/download/"}}

Comments