">mixi Developer Center (mDC)

mixi Apps

mixi Apps (English) » Technical Specification » PC » Available Information

Available Information

The mixi Platform provides various APIs and each of them can be used from a mixi App (PC version) and/or mixi Apps Mobile. Also, through APIs user profile information, lists of Friends and other information become available. mixi imposes a certain restrictions on APIs enabling the developer to access, obtain and/or update information especially personal information and other user information.

Here, we call these restriction “permission models” and the detail explanation in terms of the permission models is described as follows:

Information Applied the Permission Models

The permission models apply the following information and the developer should be aware that all of the information below belongs to a user/Owner.

  • User’s information, including: nickname, profile URL, profile image URL, blood type
    (available through Person & Friends API)
  • User’s profile information, including: address, age, birth date, gender
    (available through Person & Friends API)
  • List of Friend information (available through Person & Friends API)
  • Persistent data (available through Persistence API)

The permission models are applied when the APIs from a mixi App are used to attempt to access, obtain and/or update the information.

Conditions for the Permission Model

The following conditions are applied to check if it is allowed to access, obtain and/or update the information. The permission models will apply based on the status described below:

  • Who is the Owner of the information to be accessed/obtained or updated?
  • The relationship between the Owner of the information to be accessed/obtained or updated and the Owner and/or Viewer of a certain mixi App
  • Whether or not the Owner of the information to be accessed/obtained or updated has installed the certain mixi App
  • Type of APIs called to access, obtain and/or update information
  • Privacy setting of information to be to be accessed/obtained or updated
    (available to the public, available to Friends’ friends or available only to Friends, etc.)

The permission models are applied strictly to each mixi App, not to each developer.

General Principles

From the viewpoint “whose” information a mixi App can access, obtain or update through the APIs, in other words, these principles are explained as follows:

Permitted: Obtaining user’s information and user’s profile information of the user who has installed the mixi App.

At this point, the status whether the user is the Owner or Viewer of the mixi App is not considered. In other words, the developer is always able to specify the ID of the user who has installed a given mixi App to obtain the information while the mixi App is being executed by the user.

In this case, user’s information is available without any condtions, but for user’s profile information, only items set as available to the public, available to Friends’ friends or available only to Friends are available.

Restricted: Obtaining user’s information and user’s profile information of the users who has not installed the mixi App.

In the case that the user set the items of user’s information and user’s profile information as “available to the public”, the developer is able to obtain such information under this circumstance.

Nevertheless, the user reserves rights to configure the user’s information and the user’s profile information are not available for the developer of the mixi App which s/he has installed on the Privacy Settings page.

This rule means that if a certain user visits another user’s profile page, not her/his Friend’s profile page, visited user’s information and profile information never implicitly becomes available.

Restricted: Obtaining the list of Friends.

Only in the following circumstances, the list of Friends can be obtained:

  • Friends of owners of the mixi App being executed
  • Friends of viewers of the mixi App being executed (only when the viewer has installed the mixi App) 

In case of users other than those above, information pertaining to their Friends cannot be obtained even if the users have installed the target mixi App.

When a given user uses her/his own mixi App, the viewer and owner are the same user. In this case, if VIEWER_FRIENDS is specified by API, the same information as when specifying OWNER_FRIENDS as the permission model can be obtained.

Permitted: Obtaining the persistent data of the user who has installed the mixi App.

At this point, the status whether the user is the Owner or Viewer of the mixi App is not considered. In other words, the developer is always able to obtain the persistent data by specifying the ID of the user who has installed a given mixi App.

Obtaining the persistent data for a user who has not installed the given mixi App is never permitted.

Updating the persistent data of the user who has installed a mixi App is permitted only when the user is the Viewer.

The persistent data for the mixi App can be created, updated, and deleted only by the user (Viewer) of the mixi App as his/her own data. Any developer is never permitted to update the persistent data by specifying any user ID other than the Viewer’s ID.

Permission Matrix

The permission models above are summarized in the following tables. Please refer to the tables below focusing on whose ID is specified when obtaining each information through APIs (Owner, Viewer, Owner’s Friends, Viewer’s Friends) as well as the status if the mixi App has been installed.

Obtaining User’s Information, Profile Information, and List of Friends

??? mixi App status User’s information User’s profile information
Owner Self Installed
Friends Installed
Not installed
Viewer Self Installed
Not installed × ×
Friends (*) Installed
Not installed × ×
Others Installed
Not installed × ×
  • “●” indicates that it is possible to obtain the corresponding information.
  • “○” indicates that the corresponding information can be obtained in case either “global publication,”
    “Publication to Friends,” or “Publication to Friends of Friends” is set.
  • “▲” indicates that the corresponding information can basically be obtained, but cannot be obtained if users set OFF for publication.
  • “△” indicates that the corresponding information can basically be obtained in case of “global publication,” but cannot be obtained if users set OFF for publication.
  • * Viewers must have installed the target mixi App.
  • * If the viewer and owner are the same user, the policies displayed on the Viewer row are applied.

Obtaining and Updating the Persistent Data

  mixi App status Update (creation, modification, deletion) Obtain
Owner Self Installed ×
Friends Installed ×
Not installed × ×
Viewer Self Installed
Not installed × ×
Friends Installed ×
Not installed × ×
その他 Installed ×
Not installed × ×

 

TOP OF THIS PAGE