ソーシャルPLUS ユーザの統合
2 つのソーシャルPLUS ユーザを、1 ユーザに統合します。
GET /api/merge_user
注記
(A) 統合元のソーシャルPLUS ユーザ source_*
(B) 統合先のソーシャルPLUS ユーザ dest_*
この場合、ユーザの統合後はユーザ (A) が削除され、ユーザ (B) が残ります。
ユーザ (A) は ユーザの削除(delete_user)API で処理した場合と同様に、当該のソーシャルPLUS ID が破棄され、認証情報や個人情報、これまでのログイン履歴もすべて参照できなくなります。
注記
双方のソーシャルPLUS ユーザに同じログインアカウントが紐付いている場合は "Operation failed." エラーとなり、統合は行われません。
先に不要なログインプロバイダの連携を解除してから実行してください。
注記
この API の実行時にユーザの個人情報の再作成したくない場合は nomerge
パラメータに true
を指定してください。
ユーザの個人情報はユーザが再ログインするたびに再作成されるため、このパラメータを利用しても、統合前のログインプロバイダから取得していた個人情報が永続的に保持されるわけではありません。
リクエストパラメータ
パラメータ名 | 型 | 必須 | 説明 |
---|---|---|---|
key | string | ○ | API キー |
source_identifier | string | △1 | 統合元のソーシャルPLUS ID |
source_primary_key | string | △1 | 統合元のお客様サービス側ユーザID |
dest_identifier | string | △2 | 統合先のソーシャルPLUS ID |
dest_primary_key | string | △2 | 統合先のお客様サービス側ユーザID |
nomerge | boolean | true の場合、統合後にユーザの個人情報を更新しません |
エラーコード
HTTP Status | Code | Message | 説明 |
---|---|---|---|
401 | 1 | Invalid API key or key not found. | API キーが指定されていないか、存在しないAPIキーです |
500 | 3 | Operation failed. | ユーザ情報のマージに失敗しました |
400 | 5 | Required parameter not found. | 必須のパラメーターが指定されていません |
400 | 6 | Invalid parameter. | パラメーターに間違いがあります |
404 | 7 | Entity not found. | 指定されたユーザが存在しません |
レスポンス
キー | 型 | 最大長 | 説明 |
---|---|---|---|
status | string | 15 | リクエストが成功したかどうか(ok または failed ) |
レスポンス例
{
"status": "ok"
}
実行サンプル
curl -X GET https://api.socialplus.jp/api/merge_user -G \
-d key={API Key} \
-d source_primary_key={統合元の Primary Key} \
-d dest_primary_key={統合先の Primary Key}