2.2 山行計画
各APIへのアクセス方法は、2. API(基本仕様)をご確認ください。
1. 山行計画リストの取得(getPlanlist) ※OAuth認証不要
1. 山行計画リストの取得(getPlanlist) ※OAuth認証不要
ヤマレコに登録されている山行計画を取得する。
HTTP GETで /getPlanlist/(page) にアクセスすると、全体の計画一覧が取得できる。
HTTP GETで /getPlanlist/user/(userID)/(page) にアクセスすると、指定したユーザーの計画一覧が取得できる。取得したデータの並び順は、入山日(start)の降順(最近のものから順に並ぶ)。
?is_track=1をURLに追加すると、ルートが登録されている計画のみが取得できる。
リクエスト
レスポンス
2. 計画の検索(searchPlan) ※OAuth認証不要
2. 計画の検索(searchPlan) ※OAuth認証不要
ヤマレコに登録されている山行計画を検索する。HTTP POSTで /searchPlanにアクセスする。
private=1の計画は対象外になる。見つからない場合はエラーが返される。
リクエスト
レスポンス
→ 記録リストの取得(getPlanlist)と同様
3. 計画の取得(getPlan) ※要OAuth認証
3. 計画の取得(getPlan) ※要OAuth認証
ヤマレコに登録されている計画を取得する。
HTTP GETで /getPlan/(plan_id) にアクセスすると、該当する計画の情報が取得できる。
リクエスト
レスポンス
4. コメントリストの取得(getPlanCommentlist) ※要OAuth認証
4. コメントリストの取得(getPlanCommentlist) ※要OAuth認証
コメントのリストを取得する。
HTTP GETで /getPlanCommentlist/(plan_id) にアクセスすると、該当する計画についたコメントの情報が取得できる。
リクエスト
レスポンス