自車ステータス報告

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

■機能
自車のステータスを報告します。
「空車」を報告すると、タクトモから配車予約を受付けます。
「回送」を報告すると、タクトモから配車予約を受付けません。

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

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

guidで指定する例:
guid=docomo,sI21G7q
emailとpasswordで指定する例:
email=sample@docomo.ne.jp
password=abcde

status:必須:必ずPOSTで送信して下さい。
“空車”または”回送”を指定します。

空車=乗客を獲得したい。
回送=無線や流しで他の乗客を見つけたので、いったんタクトモの予約可能タクシーリストから自車を消したい

available_until: 必須:必ずPOSTで送信して下さい。:形式は[yyyymmddhhii]
指定した時間よりあとの乗車予約を受けないように設定できます。
タクトモ側で「空車」から「回送」に自動変更され、タクシー検索結果から消えます。
使い方としては、例えば2009年12/31の午前3時に仕事を終えて帰庫するタクシー運転手はavailable_until=200912100300のように指定しておきます。

タクシー会社の予約センターなどの電話番号を登録して24時間365日予約が入っても構わない場合は、available_until=foreverを指定すると永遠にタクシー検索結果に載り続けます。

■動作確認用URL
http://api.takutomo.com/v3/driver/set_status.php?api_key=sample_user&dev_mode=ON
(dev_mode=ONをつけるとPOST引数を入力するフォームが表示され動作例を見ることができます。返り値のサンプルを取得できます。)

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

■注意
guid による認証は準備中です。emailとpassword で指定して下さい。

Comments are closed.