「Authentication」の編集履歴（バックアップ）一覧はこちら

「Authentication」(2012/06/11 (月) 02:06:23) の最新版変更点

追加された行は緑色になります。

削除された行は赤色になります。

*Developer's API Documentation : Authentication

**認証

**キーの生成

**アカウントの照会

**アカウントの取得

**エラーコード一覧


----

*Developer's API Documentation : Authentication
http://api.toodledo.com/2/account/index.php
**認証
認証するためにはまず、セッショントークンをリクエストしなければなりません。これはGETあるいはPOSTリクエストによって、token.php APIの終着点に対して行われます。リクエストは登録されたあなたのAppIDによって署名されていなければなりません。これにより誰もあなたのアプリケーションに成りすますことができなくなります。受け取ったセッショントークンは、ほかのすべてのAPIリクエストのために用いられるキーを生成するために利用されます。

あなたはアプリケーションについて任意でいくつか詳しい情報を送ることもでき、これはあなたにとって有利に働くでしょう。こうした詳細は[[statistics page]]にて閲覧することができます。これにより、どんなデバイスであなたのアプリケーションが利用されているのかについて知ることができます。

-userid（必須）：十六進数の文字列で、あなたのアプリケーションを用いるユーザーをひとりひとり識別します。ユーザーはあなたにこれを直接与えることもできますし、account/lookupメソッドを用いることによって照会することもできます。
-appid（必須）：あなたのアプリケーションを識別するテキスト文字列です。
-vers（任意）：あなたのアプリケーションのバージョン番号を示すintegerです。
-devices（任意）：あなたのアプリケーションが実行されているデバイスやプラットフォームを識別するテキスト文字列です。
-os（任意）：あなたのアプリケーションが実行されているデバイスやプラットフォームの、オペレーティングシステムのバージョン番号を示すintegerです。
-sig（必須）：あなたのアプリケーションを有効化する署名です。useridのmd5 hashとあなたのApp Tokenを取得して生成されます。App Tokenはあなたがアプリケーションを登録した際に発行されています。　A signature to validate your application. Generated by taking the md5 hash of the userid and your App Token. The App Token was generated when you registered your app. (required)

Generating the signature with PHP
&nowiki(){$key = md5( $userid.$myAppToken );}

Generating the signature with C
&nowiki(){key = md5( userid+myAppToken );}

Generating the signature with Obj-C
&nowiki(){char *cStr = [[NSString stringWithFormat:@"%@%@",userid,myAppToken] UTF8String];}
&nowiki(){unsigned char result[CC_MD5_DIGEST_LENGTH];}
&nowiki(){CC_MD5(cStr, strlen(cStr), result);}
&nowiki(){NSString *sig = [NSString stringWithFormat: @"%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X", result[0], result[1], result[2], result[3], result[4], result[5], result[6], result[7], result[8], result[9], result[10], result[11], result[12], result[13], result[14], result[15]]; }


**キーの生成

**アカウントの照会

**アカウントの取得

**エラーコード一覧


----