カスタマーAPI

◆顧客登録

dodaiiで利用可能な顧客情報を登録します。顧客系APIの利用には、developerTokenが必要です。パラメータ名が若干他と違いますのでご注意下さい。また、顧客登録の方法に2種類のユニーク種別と、2種類のグルーピングが利用可能です。
 ユニーク種別とは、一意の顧客を識別する方法で、A「メールアドレスとパスワード」B「UDID(個体識別ID)」のどちらか、あるいはユーザーに選んでもらうなど併用することも可能です。
 グルーピングとは、顧客を「デベロッパー単位」で扱うか「アプリ単位」で扱うかの違いとなります。これはアプリ内で混在させることは原則出来ません。

 UDIDを利用する際は、特殊なソフトウエアにて偽装が可能ですので、漏洩しても差し支えないデータのみ格納ください。

◆リクエストURL

https://dodaii.com/api/v1/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
※developerTokenの確認はhttps://dodaii.com/panel/customer/での「顧客一覧」に表示されております。

◆レスポンス 

キー 意味 値の例
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/v1/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
※developerTokenの確認はhttps://dodaii.com/panel/customer/での「顧客一覧」に表示されております。

◆レスポンス

キー 意味 値の例
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/v1/customer/dataget/

◆リクエストパラメータ(POST)  

パラメータ名 意味 必須 値の例
applicationToken アプリケーショントークン 必須 drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df
developerToken デベロッパートークン 必須 drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df
id 顧客ID 必須 35

◆レスポンス

キー 意味 値の例
result 結果 success


◆顧客データ保存 

顧客のセーブデータを保存します。容量は1MBです。差分登録は出来ませんので、常に全内容を上書きして下さい。NSDictionary等をシリアライズして保管しておくと便利です。


◆リクエストURL 

https://dodaii.com/api/v1/customer/datapost/

◆リクエストパラメータ(POST) 

パラメータ名 意味 必須 値の例
applicationToken アプリケーショントークン 必須 drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df
developerToken デベロッパートークン 必須 drfiOFjfoijrfgd9+5ppJHIOFDDLFKjkopdfjg-df
id 顧客ID 必須 35
data 保存データ (バイナリデータはbase64エンコードを行ってください。)

◆レスポンス 

キー 意味 値の例
applicationId アプリケーションのID 81
customerId 顧客ID 148
data 保存データ test
timestamp タイムスタンプ 1295349065000
Comments