@nifty アバウトミーAPIで取得できるデータ種類（質問の検索）

リクエストURL

機能：: 指定した条件にマッチした質問情報を取得します。

リクエスト

パラメータ	項目名	説明	値	デフォルト値
owner	質問の作成者	質問作成者のユーザID	数値	-
answerer	質問の回答者	質問回答者のユーザID	数値	-
text	質問の内容	質問の内容（選択肢は含みません）	文字列	-
order	表示順指定	質問のソート順は、以下の指定が可能です。 hot: 回答数の降順 old_to_new: 質問の登録昇順 new_to_old: 質問の登録降順	文字列	hot
hits	取得件数	レスポンス毎に含まれる質問の件数です	数値(1-100)	20
page	取得ページ	質問一覧のページ番号です	数値	1

※注意事項
・各パラメータの複合条件(AND)は指定出来ません。
・text(質問の内容)による検索は、部分一致検索となります。
・pageパラメータは数値以外の値が設定されると"1"に設定されます。
・GETで文字列の値を設定する場合は、URLエンコードしてください。

レスポンス

パラメータ	項目名	値
response	-	-
status	statusタグ内は、共通仕様の応答メッセージを参照してください。	-
result	-	-
summary	-	-
total	全件数	数値
page	現在のページ番号	数値
page_count	全ページ数	数値
questions	-	-
question	questionsタグ内は質問の詳細情報取得のquestionタグと同じ情報が件数分表示されます。	-

サンプルレスポンス

<?xml version="1.0" encoding="UTF-8" ?> 
<response>
  <status>
    <code>200</code>
    <message>OK</message>
    <language>ja</language> 
  </status>
  <result>
    <summary>
      <total>1</total>
      <page>1</page>
      <page_count>1</page_count>
    </summary>
    <questions>
      <question>
        <id>5091</id>
        <title>鍛えるならどこ？</title>
        <url>http://aboutme.jp/question/show/5091</url>
        <creator>
          <id>1</id>
          <nickname>瀬尾 一矢</nickname>
        </creator>
        <created_at>2007-05-25Thh:mm:ss+09:00</created_at>
        <options>
          <option>
            <priority>1</priority>
            <title>これからの季節に向けて必須！二の腕</title>
          </option>
          <option>
            <priority>2</priority>
            <title>見た目で勝負！胸筋</title>
          </option>
          <option>
            <priority>3</priority>
            <title>脱いだらわかる！背筋</title>
          </option>
          <option>
            <priority>4</priority>
            <title>やっぱり気になる！腹筋</title>
          </option>
          <option>
            <priority>5</priority>
            <title>スリムに鍛えたい！太もも</title>
          </option>
          <option>
            <priority>6</priority>
            <title>鍛える必要なし！</title>
          </option>
        </options>
      </question>
      <question>
        他の該当の質問
            ：
      </questions>
  </result>
</response>

質問がヒットしない場合

質問がヒットしない場合(0件の場合)は以下の様に値を返します。

<?xml version="1.0" encoding="UTF-8" ?>
<response>
  <status>
    <code>200</code>
    <message>OK</message>
    <language>ja</language>
  </status>
  <result>
    <summary>
      <total>0</total>
      <page>1</page>
      <page_count>1</page_count>
    </summary>
    <questions>
    </questions>
  </result>
</response>

エラー

検索条件に誤りがある場合は下記の様なエラーとなります。
ステータスのコードについてはステータスコードを参照してください。

<?xml version="1.0" encoding="UTF-8" ?>
<response>
  <status>
    <code>400</code>
    <message>APIのパラメータが不正です。</message>
    <language>ja</language>
  </status>
  <result>
  </result>
</response>

@niftyのウェブサービスを使ってアプリケーションを作ってみよう！

質問の検索

リクエストURL

リクエスト

レスポンス

サンプルレスポンス

質問がヒットしない場合

エラー

提供API

メニュー

開発者ブログ

関連サービス