">mixi Developer Center (mDC)

mixi Apps

mixi Apps (English) » Applications, Registration and Inquiries » (Japanese) アプリの変更・削除に関する申請・登録 » Change Application Setting » Procedure for migrating mixi app APIs to the new user ID system

Procedure for migrating mixi app APIs to the new user ID system

Currently, you can use only use numbers for the user IDs. We plan to change the user ID specification so that hashed (henceforth called "cross-platform") alphanumeric characters (13 digits) can be used. We think that you have been preparing for the change. From June 29, 2011, you will be able to migrate to the cross-platform user ID system (henceforth called "new system") when you use APIs.
After the migration to the new system, APIs will not operate with the number-only system (henceforth called "old system").

Once you migrate to the new system, you cannot return to the old one. Please be sure to migrate to the new system after sufficient verification.

When you register new apps after June 29, 2011, you will not need to migrate because you will register using the new system. (In this case, the buttons described below will not appear in Partner Dashboard.)

Apps that require the migration

Apps that were registered before June 29, 2011

・ You must migrate an app when the "ID conversion API" item appears in "Applications" on the app configuration page (https://sap.mixi.jp/edit_appli.pl?id=[App ID]) in Partner Dashboard as in the image below,

Procedure for migrating mixi app APIs to the new user ID system-1

Migrating to the new system

Migration to the new system consists of two steps:

  1. Prepare to replace the user IDs for the old system with the new one.
  2. Migrate the mixi application APIs to the new system.

The following describes the two steps.

(1) Prepare to replace the user IDs for the old system with the new one.

Use the ID conversion API to prepare to replace the user IDs for the old system with those for the new one.

First, open the app configuration modification page to edit the configuration for the mixi application where you replace the user IDs.
* For information on how to access the app configuration modification page, see here.

For the "ID conversion API" item on the app configuration modification page, press the "Use the ID conversion API" button.

Procedure for migrating mixi app APIs to the new user ID system-2

You must agree with the terms of use to use the ID conversion API. Press the "Agree and register" button.

Procedure for migrating mixi app APIs to the new user ID system-Agree

The completion screen appears.。

Procedure for migrating mixi app APIs to the new user ID system-Finish

After the registration, the "platformUserId" field is added to the Person & Friends API. The field contains the user ID for the new system.

Now you can use this information to replace the user ID with the ID for the new system.

For the details of the Person & Friends API, see the following documents.

RESTful API specifications

For the conditions for obtaining user IDs for the new system, see the following document.

Information that can be obtained

(2) Migrate the mixi application APIs to the new system.

When you have prepared to replace the user IDs using the ID conversion API, migrate the mixi app API to the new system.

Yet in regards to API conversion User ID (Person & Friends API), the platform non-unified user ID can be used in place of the platform unified user ID even after the end of October. In the life cycle event, there are cases in which the platform non-unified user ID is sent after pushing the "completed" button. Therefore please continue using the API conversion as necessary.

For the "ID conversion API" item on the "app configuration modification" page, press the "Cross-platform IDs supported" button.
(When the "Use the ID conversion API" button appears, the user ID has not been migrated to the new system. Start from step (1).)

Procedure for migrating mixi app APIs to the new user ID system-Button

You must agree with the alert to complete the ID conversion. Select the check box and press the "Agree and register" button.

Once you press the "Agree and register" button here, you cannot return to the old system. Please be careful.

Procedure for migrating mixi app APIs to the new user ID system-Completion The completion screen appears.ID_API_finished_done.gif

The mixi app APIs have been migrated to the new system. Now you can only use the user IDs for the new system in the APIs.

This completes the migration of the user IDs to the new system.

Thank you for your cooperation.

TOP OF THIS PAGE