API
Minkaku API について
みんなの拡張機能の機能をAPIとして公開しています。Minkaku APIとは、他のプログラムからMinkakuにアクセスするために提供している外部プログラムインターフェースです。Minkaku APIを使用することによって、Minkakuの登録情報を活用したマッシュアップサイトを作成することができます。
APIによるアクセスは1リクエスト/秒までを目安としてください。サービスに影響の出る過剰なアクセスは制限させていただく場合がありますのでご了承ください。
Minkaku APIは、Mash up Award 3rdに参加しています。
API
リクエストURL
http://minkaku.goga.co.jp/api/search.php?パラメータ名=パラメータ値&...リクエストパラメータ
| 文字列検索パラメータ | |
|---|---|
| パラメータ名 | 説明 |
| query | 拡張機能の名前に含まれる文字列を指定します。 指定しない場合全ての拡張機能にマッチします。 |
| 出力制御パラメータ | ||
|---|---|---|
| パラメータ名 | 説明 / 指定できる値 | |
| start | 検索結果の何番目から出力するかを指定します。(デフォルト: 1) | |
| max | 最大何件まで出力するかを指定します。(デフォルト: 10,最大: 30) | |
| sortby | 出力結果のソートに使用するキーを指定します。指定できるキーは以下のとおりです。 | |
| ranking | 投票数ランキング (デフォルト) | |
| date | 初めてMinkakuに投票された日時 | |
| name | 拡張機能の名前 | |
| order | ソート順序を指定します。指定できる値は以下のとおりです。 | |
| asc | 昇順 (デフォルト) | |
| desc | 降順 | |
| output | 出力形式を指定します。指定できる値は以下のとおりです。 | |
| xml | XML形式 (デフォルト) | |
| csv | CSV形式 | |
リターンパラメータ (XML形式)
| パラメータ名 | 説明 |
|---|---|
| NumOfResult | ヒット件数を示します。 |
| Rank | 拡張機能のMinkaku内での順位を示します。 |
| Name | 拡張機能の名前を示します。 |
| URL | 拡張機能の配布元URLを示します。 |
| NumOfVote | 拡張機能への投票数を示します。 |
リターンパラメータ (CSV形式)
拡張機能の順位,拡張機能の名前,配布元URL,投票数\r\n...
利用例
1位から10位までの拡張機能の情報を順にXML形式で取得する (すべてデフォルト)http://minkaku.goga.co.jp/api/search.php名前に"Vista"を含む拡張機能を新着順に5個まで取得するhttp://minkaku.goga.co.jp/api/search.php?query=vista&sortby=date&order=desc&max=5