予約中と予約したタクシー取得

APIメソッド:http://api.takutomo.com/v3/member/get_reserved_driver.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_reserved_driver.php?api_key=sample_user&dev_mode=ON
(dev_mode=ONをつけるとPOST引数を入力するフォームが表示され動作例を見ることができます。返り値のサンプルを取得できます。)

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

■返り値のフォーマット

<reserved_driver_1>
<driver_id>運転手の会員番号</driver_id>
<name>運転手の名前</name>
<company>運転手の会社名</company>
<depart_date>出発日</depart_date>
<depart_time>出発時間</depart_time>
<from>出発地の住所文字列</from>
<to>目的地の住所文字列</to>
<phone>運転手の電話番号</phone>
<request_id>予約番号</request_id>
<evaluated>評価済みかどうか[1|0]</evaluated>
</reserved_driver_1>

Comments are closed.