記事リストAPI

リクエストURL
http://okyuu.com/ja/api/[item_type]/list?sort=[sort]&page=[page]&format=[format]&callback=[callback]
リクエストパラメータ
パラメータ名 説明
item_type *必須 記事タイプ
tips : ノウハウ
news : ニュース
question: Q＆A
sort 並び順
new : 新着順
rating : 評価順
access : アクセス数順
clip : クリップ数順
comment : コメント数順
page ページ番号
一度に5セットずつ結果を返します
format *必須 返却フォーマット
xml : xml
js : json
callback コールバック関数
formatがjsの場合に指定の関数に結果をコールバックします
*リクエストは、UTF-8でURLエンコードしてください
リターンパラメータ
パラメータ名 説明 データ型
has_error エラーが発生したかどうか
0:発生しなかった
1:発生した 		Integer
status ステータス
200:正常
404:見つからなかった
500:システムエラー
503:メンテナンス
 Integer
size ヒット数 Integer
last_page 最後のページ番号 Integer
list_par_page ページあたりの記事数 Integer
current_page 現在のページ Integer
item *配列 記事情報
パラメータ名 説明 データ型
url 記事URL String
data_type データタイプ
1 : ピックアップ記事
2 : 書き込まれたノウハウと質問
 Integer
item_type 記事タイプ
tips : ノウハウ
news : ニュース
question: Q＆A
 String
is_open 更新可能か
0 : 不可能(質問が締め切られた場合等)
1 : 可能
Integer
title 記事タイトル String
id 記事ID Integer
poster 投稿者情報
パラメータ名 説明 データ型
name ユーザネーム String
url ユーザURL String
Struct
created_at 記事が投稿された日時 (UNIXTIME) Integer
comments_count コメント数 Integer
clips_count クリップ数 Integer
access_count アクセス数 Integer
rates_count 評価数 Integer
rating 評価 Float
category カテゴリ情報
パラメータ名 説明 データ型
name カテゴリ名 String
path カテゴリパス String
url カテゴリURL String
Struct
tag タグ情報配列
パラメータ名 説明 データ型
name タグ名 String
url タグURL String
Struct Array
Struct Array
サンプル
リクエスト
XMLで返却
http://okyuu.com/ja/api/news/list?sort=new&page=1&format=xml
JSONで返却
http://okyuu.com/ja/api/news/list?sort=new&page=1&format=js
JSONで返却(callback指定)
http://okyuu.com/ja/api/news/list?sort=new&page=1&format=js&callback=Class.function
エラー
エラーコード 説明
200正常に処理されました
404該当する記事が見つかりませんでした
500システムエラーが発生しました
503メンテナンス中です
例

<?xml version="1.0" encoding="UTF-8"?>
<OkyuuData>
<has_error>1</has_error>
<status>404</has_error>
</OkyuuData>

クレジット表示について
okyuu.comAPIを利用して作成したアプリケーションには、下記クレジットを表示してください
WEB Services by okyuu.com