プロフィール変更
APIメソッド:http://api.takutomo.com/v3/member/edit_profile.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
guidと emailの両方を指定した場合はguid による認証が優先されemailは無視されます。
item:必須:必ずPOSTで送信して下さい。
次の中から1つを選びます。
name:名前
guid:個体識別番号
gae:年齢
gender:性別
introduction:自己紹介
event_mail:自分の地域で相乗り募集があった場合に通知メールを受けるかどうか設定
user_mail:他メンバーから自分あてのメッセージを受信した場合に通知メールを受けるかどうか設定
mail_magazine:タクトモからのメルマガを受けるかどうか設定
from1:よくタクシーに乗ることがある出発地
from2:よくタクシーに乗ることがある出発地
from3:よくタクシーに乗ることがある出発地
from4:よくタクシーに乗ることがある出発地
from5:よくタクシーに乗ることがある出発地
from1_lat:よくタクシーに乗ることがある出発地の緯度(世界測位系)
from2_lat:よくタクシーに乗ることがある出発地の緯度(世界測位系)
from3_lat:よくタクシーに乗ることがある出発地の緯度(世界測位系)
from4_lat:よくタクシーに乗ることがある出発地の緯度(世界測位系)
from5_lat:よくタクシーに乗ることがある出発地の緯度(世界測位系)
from1_lon:よくタクシーに乗ることがある出発地の経度(世界測位系)
from2_lon:よくタクシーに乗ることがある出発地の経度(世界測位系)
from3_lon:よくタクシーに乗ることがある出発地の経度(世界測位系)
from4_lon:よくタクシーに乗ることがある出発地の経度(世界測位系)
from5_lon:よくタクシーに乗ることがある出発地の経度(世界測位系)
to1:よくタクシーに乗ることがある目的地
to2:よくタクシーに乗ることがある目的地
to3:よくタクシーに乗ることがある目的地
to4:よくタクシーに乗ることがある目的地
to5:よくタクシーに乗ることがある目的地
to1_lat:よくタクシーに乗ることがある目的地の緯度(世界測位系)
to2_lat:よくタクシーに乗ることがある目的地の緯度(世界測位系)
to3_lat:よくタクシーに乗ることがある目的地の緯度(世界測位系)
to4_lat:よくタクシーに乗ることがある目的地の緯度(世界測位系)
to5_lat:よくタクシーに乗ることがある目的地の緯度(世界測位系)
to1_lon:よくタクシーに乗ることがある目的地の経度(世界測位系)
to2_lon:よくタクシーに乗ることがある目的地の経度(世界測位系)
to3_lon:よくタクシーに乗ることがある目的地の経度(世界測位系)
to4_lon:よくタクシーに乗ることがある目的地の経度(世界測位系)
to5_lon:よくタクシーに乗ることがある目的地の経度(世界測位系)
例:”name”
value:必須:必ずPOSTで送信して下さい。
guidの場合は、携帯端末を買い換えた場合などに使用します。値のフォーマットは、新規会員登録(guid)と同じです。
注意:個体識別番号で登録したユーザーで、メールアドレスを登録していないユーザーは、携帯電話を買い換えるとログインできなくなります。
買い換える前にメールアドレスを登録させて、新しい機種でメールアドレスを認証引数として本APIを使用して、新しい個体識別番号を登録させて下さい。
値のフォーマットの詳細は、新規会員登録(guid)をご覧下さい。
nameの場合はUTF-8エンコーディングして送って下さい。
例:”山田太郎”
ageの場合は半角数字で指定します。タクトモ側では10代、20代、30代・・80代に振り分けられてDBに格納されます。
例:”30″
genderの場合は性別をUTF-8エンコーディングして送って下さい。
“男” または “女”
introductionの場合はUTF-8エンコーディングして送って下さい。
例:”よくタクシーを使います。”
event_mail、user_mail、mail_magazineの場合は、yes または no を送って下さい。
from1 ~ from5、to1 ~ to5 の場合は住所または駅名をUTF-8エンコーディングして送って下さい。
例:”東京都港区六本木”
例:”新宿駅”
from1_lat ~ from5_lat、from1_lon ~ from5_lon、to1_lat ~ to5_lat、to1_lon ~ to5_lon の場合は世界測位系で緯度または経度を半角数字で送って下さい。
■動作確認用URL
http://api.takutomo.com/v3/member/edit_profile.php?api_key=sample_user&dev_mode=ON
(dev_mode=ONをつけるとPOST引数を入力するフォームが表示され動作例を見ることができます。返り値のサンプルを取得できます。)
■返り値
成功の場合、status code に 0000~0999 が返ります。
失敗の場合は、status_codeに1000以上の数字が返ります。
成功の場合も、失敗の場合も、description に成功したメッセージまたはエラーの内容が返ります。そのままユーザーに表示できるように意図したメッセージ内容が返ります。