タクシーを評価
APIメソッド:http://api.takutomo.com/v3/member/eval_user.php?api_key=xxxxxxx
■機能
相手に評価をつけます。引数の渡し方によって下記の3通りの使い方ができます。
1、乗客がタクシー運転手に評価をつける。
2、タクシー運転手が乗客に評価をつける。
3、相乗り相手に評価をつける。
良い、普通、悪いの3段階で評価し、コメント(任意)を入力します。
タクトモでは、相手の信用性をDBに保存し、次の人のため与信情報として使用しますので、必ずこのAPIを実装して下さい。
■引数
api_key:必須:必ずGETで送信して下さい。
あなたのサイト/アプリからタクトモAPIへアクセスするためのAPI KEYです。タクトモに申請すると無料で取得できます。
guidだけ または emailとパスワードの両方:必須:必ずPOSTで送信して下さい。
そのユーザーが登録した認証情報を送信して下さい。ユーザーを特定するために使われます。
guidで指定する例:
guid=docomo,sI21G7q
emailとpasswordで指定する例:
email=sample@docomo.ne.jp
password=abcde
request_id または event_id:必須:必ずPOSTで送信して下さい。
request_id は乗客がタクシー運転手に評価をつける場合と、タクシー運転手が乗客に評価をつける場合に、タクシーの予約番号を指定します。
予約番号は、get_reserved_driver で取得できます。
event_id は乗客同士が評価をつける場合に、相乗り案件番号を指定します。
相乗り案件番号は、get_attend_event で取得できます。
id:必須:必ずPOSTで送信して下さい。評価する相手の会員番号
comment:任意:必ずPOSTで送信して下さい。
相手へのコメント。UTF-8エンコーディングして送って下さい。
例:「きれいな車内で気持ちよく乗車できました。」(運転手への評価)
例:「またのご乗車お待ちいたします。」(乗客への評価)
例:「楽しく帰ることができました。」(相乗り相手への評価)
■動作確認用URL
http://api.takutomo.com/v3/member/eval_user.php?api_key=sample_user&dev_mode=ON
(dev_mode=ONをつけるとPOST引数を入力するフォームが表示され動作例を見ることができます。返り値のサンプルを取得できます。)
■返り値
成功の場合、status code に 0000~0999 が返ります。
失敗の場合は、status_codeに1000以上の数字が返ります。
成功の場合も、失敗の場合も、description に成功したメッセージまたはエラーの内容が返ります。そのままユーザーに表示できるように意図したメッセージ内容が返ります。