※上記の広告は60日以上更新のないWIKIに表示されています。更新することで広告が下部へ移動します。

Developer's API Documentation : Authentication

認証

認証するためにはまず、セッショントークンをリクエストしなければなりません。これは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
$key = md5( $userid.$myAppToken );

Generating the signature with C
key = md5( userid+myAppToken );

Generating the signature with Obj-C
char *cStr = [[NSString stringWithFormat:@"%@%@",userid,myAppToken] UTF8String];
unsigned char result[CC_MD5_DIGEST_LENGTH];
CC_MD5(cStr, strlen(cStr), result);
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]];


キーの生成


アカウントの照会


アカウントの取得


エラーコード一覧