他会員に直接メッセージ送信
APIメソッド:http://api.takutomo.com/v3/member/send_message.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
id:必須:必ずPOSTで送信して下さい。
ダイレクトメッセージを送信したい相手の会員番号。
message:必須:必ずPOSTで送信して下さい。
ダイレクトメッセージの本文。UTF-8エンコーディングして送って下さい。
例:「駅についたら電話下さい。090-1234-5678です。」
■動作確認用URL
http://api.takutomo.com/v3/member/send_message.php?api_key=sample_user&dev_mode=ON
(dev_mode=ONをつけるとPOST引数を入力するフォームが表示され動作例を見ることができます。返り値のサンプルを取得できます。)
■返り値
成功の場合、status code に 0000~0999 が返ります。
失敗の場合は、status_codeに1000以上の数字が返ります。
成功の場合も、失敗の場合も、description に成功したメッセージまたはエラーの内容が返ります。そのままユーザーに表示できるように意図したメッセージ内容が返ります。