相乗り参加案件を取得

APIメソッド:http://api.takutomo.com/v3/member/get_attend_event.php?api_key=xxxxxxx

■機能
自分が参加中の相乗り募集および参加した案件の募集ID、評価済みかどうかを取得します。
参加中の相乗り募集の応募者が増えたかどうか確認したり、掲示板のやりとりを確認する画面を作るときにこのAPIを使用します。
1~3ヶ月すると古い案件が消えていきます。

■引数
api_key:必須:必ずGETで送信して下さい。
あなたのサイト/アプリからタクトモAPIへアクセスするためのAPI KEYです。タクトモに申請すると無料で取得できます。

guidだけ または emailとパスワードの両方:必須:必ずPOSTで送信して下さい。
そのユーザーが登録した認証情報を送信して下さい。ユーザーを特定するために使われます。

guidで指定する例:
guid=docomo,sI21G7q
emailとpasswordで指定する例:
email=sample@docomo.ne.jp
password=abcde
■動作確認用URL
http://api.takutomo.com/v3/member/get_attend_event.php?api_key=sample_user&dev_mode=ON

(dev_mode=ONをつけるとPOST引数を入力するフォームが表示され動作例を見ることができます。返り値のサンプルを取得できます。)

■返り値
成功の場合、status code に 0000~0999 が返ります。
失敗の場合は、status_codeに1000以上の数字が返ります。
成功の場合も、失敗の場合も、description に成功したメッセージまたはエラーの内容が返ります。そのままユーザーに表示できるように意図したメッセージ内容が返ります。

■返り値のフォーマット
<attend_event_1>
<event_id>相乗り案件番号</event_id>
<leader_m_id>募集者の会員番号</leader_m_id>
<name>募集者の名前</name>
<depart_date>出発日</depart_date>
<depart_time>出発時間</depart_time>
<from>出発地の住所文字列</from>
<to>目的地の住所文字列</to>
<attend_m_id>相乗りに参加している会員の会員番号</attend_m_id>
<attend_name>相乗りに参加している会員名</attend_name>
<to_be_evaluated_id>まだ評価していない参加者の会員番号</to_be_evaluated_id>
</attend_event_1>

Comments are closed.