ログイン
IDでもっと便利に[ 新規取得 ]

震災関連情報

災害ボランティア検索API

Version 1

リクエストURL

XML

PHPSerialize

JSON

http://shinsai.yahooapis.jp/v1/volunteers

災害ボランティア情報で掲載されている情報の検索機能を適用するAPIです。

※情報提供:ボランティアインフォ、ボランティアプラットフォーム
※本APIは、期間限定のAPIです。更新頻度、サービスの提供期間・終了日は未定ですが、決まり次第、掲載します。
※被災地のNPOなどから提供された情報をそのまま記載しております。掲載情報に不備があることもございます。あらかじめご了承ください。
※情報提供元の情報開示内容が変更になった場合、本APIの仕様も予告なく変更になる場合があります。
※利用にはアプリケーションIDが必要です。

リクエストパラメータ

パラメータ説明
appid
(必須)
string アプリケーションID。詳細はアプリケーションIDのヘルプをご覧ください。
query string URLエンコードされた検索クエリーです。文字コードはUTF-8です。
id string メッセージIDで検索します。
results integer
(デフォルト:20
検索結果の返却数を指定します。指定できる最大値は30です。
start integer
(デフォルト:1
検索結果の先頭位置を指定します。
lat float 緯度。
lon float 経度。
sort string
(デフォルト:-date
検索条件を指定します。
  • +date 更新時間昇順
  • -date 更新時間降順
  • +dist 距離昇順
  • -date 距離降順
status enum(-1,0,1)
デフォルト:1
掲載ステータスを絞り込みます。
  • 0: 掲載終了したもの
  • 1: 掲載中のもの
  • -1: ステータスによらず全て
output enum
(xml, php, json)
デフォルト:xml
出力形式を指定します。省略した場合、XML形式となります。
callback string
デフォルト:(なし)
output=jsonを指定した場合、このパラメータを指定するとレスポンスがJSONP形式になります。callback関数名を指定します。

サンプルリクエストURL

http://shinsai.yahooapis.jp/v1/volunteers?id=tasukeai_japan_462&appid=<あなたのアプリケーションID>

レスポンスフィールド

フィールド説明
Messages ルートノードです。以下のノードを含みます。
  • totalResultsAvailable: クエリにマッチしたデータ数です。
  • totalResultsReturned: このレスポンスに含まれるデータの数です。
  • firstResultPosition: 最初のMessageのポジションです。
フィールド説明
Message 各個別レスポンスを含みます。
フィールド説明
Body募集メッセージ
Id各募集のユニークなID
Url対応するYahoo!ボランティアページのURL
Contact連絡先
ContactPerson連絡先氏名
Pref県ID(JISコード) 0→全国, 99→その他
Organization組織名
Summary詳細情報
Title募集メッセージのタイトル
RegTime登録された時間(RFC3339)
UpdateTime情報が最後に変更された時間(RFC3339)
Address場所
Lat緯度
Lon経度
Status1: 募集中 0: 募集終了

サンプルレスポンス

XMLのレスポンス例

エラー

このAPIは、Yahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

このAPIは、24時間中1アプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。