相乗りに参加、キャンセルする
APIメソッド:http://api.takutomo.com/v3/member/add_event_comment.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
event_id:必須:必ずPOSTで送信して下さい。
相乗りに参加したり、掲示板にコメントを書込みたい相乗りの案件番号。
案件番号は、member/search_event で取得できます。
comment:必須:必ずPOSTで送信して下さい。
掲示板へ書き込むコメント。UTF-8エンコーディングして送って下さい。
例:「参加します。新宿西口にいます。立川まで乗車希望です。」
例:「参加をキャンセルします。すみません。」
cancel:任意:必ずPOSTで送信して下さい。
一旦応募したユーザーが参加をキャンセルする場合は、cancel=yesを送って下さい。
相乗り
例:「参加します。新宿西口にいます。立川まで乗車希望です。」
例:「参加をキャンセルします。すみません。」
■注記事項
相乗り参加をキャンセルします。
このAPIでは、募集を立てたユーザーはキャンセルできません。応募者のみキャンセルできます。
募集者が相乗りをキャンセルする場合は、「すみません、相乗り募集を立てましたが都合が悪くなったのでキャンセルします。」
等と掲示板へ募集したユーザー自身が書込みするよう促して下さい。
募集者自身がキャンセルする機能はインフラとしてはありません。上記の運用方法でキャンセルしたこととして運用されています。
■動作確認用URL
http://api.takutomo.com/v3/member/add_event_comment.php?api_key=sample_user&dev_mode=ON
(dev_mode=ONをつけるとPOST引数を入力するフォームが表示され動作例を見ることができます。返り値のサンプルを取得できます。)
■返り値
成功の場合、status code に 0000~0999 が返ります。
失敗の場合は、status_codeに1000以上の数字が返ります。
成功の場合も、失敗の場合も、description に成功したメッセージまたはエラーの内容が返ります。そのままユーザーに表示できるように意図したメッセージ内容が返ります。