アップルより、自動継続課金が提供されていますので、月額課金の利用を検討されている場合はアップルの自動継続課金をご利用ください。
◆顧客登録
dodaiiで利用可能な顧客情報を登録します。顧客系APIの利用には、developerTokenが必要です。パラメータ名が若干他と違いますのでご注意下さい。また、顧客登録の方法に2種類のユニーク種別と、2種類のグルーピングが利用可能です。
ユニーク種別とは、1意の顧客を識別する方法で、A「メールアドレスとパスワード」B「UDID(個体識別ID)」のどちらか、あるいはユーザーに選んでもらうなど併用することも可能です。
グルーピングとは、顧客を「デベロッパー単位」で扱うか「アプリ単位」で扱うかの違いとなります。これはアプリ内で混在させることは原則出来ません。
UDIDを利用する際は、特殊なソフトウエアにて偽装が可能ですので、漏洩しても差し支えないデータのみ格納ください。
◆リクエストURL
https://dodaii.com/api/v2/customer/register/
◆リクエストパラメータ(POST)
パラメータ名 |
意味 |
必須 |
値の例 |
groupType |
グループタイプ |
必須 |
developer または application のどちらか |
applicationToken |
アプリケーショントークン
アプリケーションを一意に特定するトークン |
必須 |
drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df |
developerToken |
デベロッパートークン
デベロッパーを一意に特定するトークン(※) |
必須 |
drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df |
uniqueType |
ユニーク種別 |
必須 |
mail または udid のどちらか |
mailAddress |
メールアドレス |
uniqueType=mailの場合必須 |
support@dodaii.com |
password |
パスワード |
uniqueType=mailの場合必須 |
pass1234 |
udid |
機種個別ID |
uniqueType=udidの場合必須 |
eac2e3524c5aedcd3dec75r |
◆レスポンス
キー |
意味 |
値の例 |
createdAt |
作成日時 |
1295342186673 |
groupType |
グループタイプ |
developer または application のどちらか |
id |
顧客ID |
137 |
mailAddress |
メールアドレス |
support@dodaii.com
|
name |
name |
example |
udid |
機種個別ID |
eac2e3524c5aedcd3dec75r |
uniqueType |
ユニーク種別 |
mail または udid のどちらか |
◆顧客情報取得
顧客のセーブデータ以外の基本情報を取得可能です。一般的なシステムにおけるログインと同様のAPIですが、セッションの概念はありません。ユーザデータ取得に必要な顧客IDを返却します。
◆リクエストURL
https://dodaii.com/api/v2/customer/find/
◆リクエストパラメータ(POST)
パラメータ名 |
意味 |
必須 |
値の例 |
groupType |
グループタイプ |
必須 |
developer または application のどちらか |
uniqueType |
ユニークタイプ |
必須 |
udid または mail のどちらか |
applicationToken |
アプリケーショントークン
アプリケーションを一意に特定するトークン |
必須 |
drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df |
developerToken |
デベロッパートークン
デベロッパーを一意に特定するトークン(※) |
必須 |
drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df |
mailAddress |
メールアドレス |
uniqueType=mailで登録された顧客を検索する場合必須 |
support@dodaii.com |
password |
パスワード |
uniqueType=mailで登録された顧客を検索する場合必須 |
pass1234 |
udid |
機種個別ID |
uniqueType=udidで登録された顧客を検索する場合必須 |
eac2e3524c5aedcd3dec75r |
◆レスポンス
キー |
意味 |
値の例 |
createdAt |
作成日時 |
1295342186673 |
groupType |
グループタイプ |
developer または application のどちらか |
id |
顧客ID |
137 |
mailAddress |
メールアドレス |
support@dodaii.com
|
name |
name |
example
|
udid |
機種個別ID |
eac2e3524c5aedcd3dec75r |
uniqueType |
ユニーク種別 |
mail または udid のどちらか |
◆顧客データ取得
顧客のセーブデータを取得します。1アプリ/1顧客に対して1データのみ保持されています。
◆リクエストURL
https://dodaii.com/api/v2/customer/dataget/
◆リクエストパラメータ(POST)
パラメータ名 |
意味 |
必須 |
値の例 |
applicationToken |
アプリケーショントークン |
必須 |
drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df |
developerToken |
デベロッパートークン |
必須 |
drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df |
id |
顧客ID |
必須 |
35 |
◆レスポンス
キー |
意味 |
値の例 |
result |
結果 |
success |
◆顧客データ保存
顧客のセーブデータを保存します。容量は1MBです。差分登録は出来ませんので、常に全内容を上書きして下さい。NSDictionary等をシリアライズして保管しておくと便利です。
◆リクエストURL
https://dodaii.com/api/v2/customer/datapost/
◆リクエストパラメータ(POST)
パラメータ名 |
意味 |
必須 |
値の例 |
applicationToken |
アプリケーショントークン |
必須 |
drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df |
developerToken |
デベロッパートークン |
必須 |
drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df |
id |
顧客ID |
必須 |
35 |
data |
保存データ |
(バイナリデータはbase64エンコードを行ってください。) |
◆レスポンス
キー |
意味 |
値の例 |
applicationId |
アプリケーションのID |
81 |
customerId |
顧客ID |
148 |
data |
保存データ |
testaaaaaaaaaaaaaa |
timestamp |
タイムスタンプ |
1295349065000 |
|