An introduction to mixi Graph API

2

Regarding mixi API

Copyright (C) mixi, Inc. All rights reserved.

3

About mixi Apps API & mixi Graph API

mixi Platform
Base to create mixi application and services using the social graph
・mixi Graph API
API that can be used by Web services or from various devices
・mixi Apps
An application that runs inside mixi（e.g. Sunshine Bokujyo)

Web service
mixi Graph API mixi
mixi Apps API
Application

mixi Applications


4

List of mixi Graph API (http://developer.mixi.co.jp/en/connect/mixi_graph_api/mixi_io_spec_top/)

The following API are the available mixi Graph API for developers to use. By using the
relevant API, a developer can create a highly social experience for users.
Category API API capabilities

Profile related People API Can acquire information or IDs of a user or his/her friends

Groups API Can acquire information on the groups the user manages. (e.g.
name of the group, group ID).
People lookup API Can find the user IDs for a friend by searching using an email
address
Profile Image API Can acquire profile pictures for a user or his//her friends. Also
this API allows user to modify his/her own profile picture
Content Voice API Can post and acquire mixi Voice posts

Diary API Can post a diary entry

Photo API Can acquire and post photos in the mixi albums

Check-in API Can acquire and post check-in information

Information Updates API Can acquire friend updates
Updates
Check API Can post the mixi check feed

Message Message API Can send and acquire messages to and from friends


5

List of mixi Apps API (http://developer.mixi.co.jp/en/appli/spec/)

The following API are the available mixi Apps API for developers to use. By using the
relevant API, a developer can create a rich application experience for users.
Category API API capabilities

Profile related People API Can acquire information or IDs of a user or his/her
friends
Content Photo API Can acquire and post photos in the mixi albums

Voice API（posting only） Can post mixi Voice posts

Community API Can acquire information on what types of mixi
communities the user participates in
Notification Message API（Sending Can send messages to friends
only）
Request API Can send requests to friends

Invite API Can send friends invitations to a particular app

Communication Feed API Can inform friends of a user’s actions performed in an
application
Storing data Persistence API Can save and acquire user information on the mixi
server
Payment Payment API Allows the use of the mixi payment system


6

The difference between mixi Graph and mixi Apps

mixi Graph API： Delivers API that enables various methods to use mixi contents
mixi Apps API：Delivers API that promotes sharing among friends
Profile Information
Content Notification
related Updates

People API Voice API Message API Updates API
mixi Graph API

Groups API Diary API Check API

People lookup API Photo API

Profile ImageAPI Check-in API

Message API Payment
People API Photo API （only sending capability）
Payment API
Mixi Apps

Voice API（only Request API
posting capability）

Communication Storing data
Invite API
API
Communication Persistence API
Feed API


7

Case examples of using mixi API
mixi Graph API version


8

Case examples of using mixi API（mixi Graph API version）

People API can be used to acquire a list of mixi friends for a user and then a
“follow” function can be built into the application to promote further
engagement among friends

machi


9


The Message API can be used to allow users to invite their friends to start
using a particular application


10


Voice API can be used to allow users to post photos using mixi Voice. A link
can be added within the mixi Voice post to redirect users to the application.


11


With the combination of mixi API: People API・Voice API・Updates API and
an externally developed API there are many possibilities. For instance if a
text analyzer API existed it could be used with the mixi API to analyze and
convey the emotion of a user’s posts
【Emotional Voice】

Text Analyzer
People API API
・General ・mixi Voice
information of test analyzer
friends

Updates API
・Friend’s recent
mixi Voice posts


12


The Profile Image API can be used to easily update a user’s profile picture
straight from an external application


13

An introduction of mixi API SDK


14

What is the mixi API SDK?

○ Official library for the native application on
smartphones

○ Makes it easier to access mixi API
○ mixi Graph API
○ mixi Apps

○ OS
○ Android
○ iOS


15

What is the mixi API SDK?

External Service Smartphone native app mixi Apps

Apps／
Service

Library mixi API SDK

API mixi Graph API mixi Apps API


16

mixi API SDK features

Features

○ SDK supports the OAuth2.0 authorization
○ The access token can be acquired by calling just 1
method
○ The SDK also automatically refreshes (reissues) the
access token

○ Secure
○ For Android, there is no need to add a secret

○ Not only can the SDK be added to new application
but the SDK can be added to existing applications as
well

17

OAuth2.0 Flow

User Application mixi

Starts using the
application

code
User
Authorization code
Authorization
issued

code

Token

Access token
issued
Token

Access token acquired


18

Flow of SDK approval

User Application

Starts to use the
application

SDK
User Authorization

Token

Access Token Acquired


19

Flow of SDK approval（diagram of SDK’s intermediary function）

User Application mixi

Starts to use the
application
SDK

SDK

code
User Authorization SDK Authorization code
code
issued

Token
SDK
Token Access token
issued
Token

Access token acquired


20

mixi API SDK summary

Features
○ Official library for the native application on
smartphones
○ Android
○ iOS
○ Facilitates the use of mixi API
○ Supports OAuth2.0
○ Not only can the SDK be added to new application
but the SDK can be added to existing applications as
well Why not take it for a test drive?♪


21

demo


22

demo

Voice API
○ mixi Voice post
○ Supports posts which include photos
○ Since mixi saves the photos, there is no need to keep a separate
storage of photos


23

Voice API

External Service Smartphone native app mixi Apps

App／
Service

Library mixi API SDK

Voice API
API mixi Graph API mixi Apps API


24

demo

Easily post a
mixi Voice using the SDK☆


25

Coding example using the SDK (for Android)

Authorization

mContainer.authorize(TestActivity.this, new String[]
{"r_profile","w_voice"}, CODE,
new CallbackListener() {
@Override
public void onComplete(Bundle values) {
// Success
}

});


26

Coding example using the SDK (for Android)

Posting a mixi Voice

Map params = new HashMap();
params.put("status", “HELLO");
mContainer.send("/voice/statuses/update", HttpMethod.POST, params, new Callback()
{
@Override
public void onComplete(Bundle values) {
// Success
}

});


27

demo

Easily post a
mixi Voice using mixi
Graph☆


28

Voice API

Posting a mixi Voice

POST http://api.mixi-
platform.com/2/voice/statuses/update
POST http://api.mixi-platform.com/2/voice/statuses
Parameter Value
status mixi Voice body, contents（URI encoded withUTF-8）

Use curl to post“Thanks for your help”using mixi
Voice
curl -v -H ‘Authorization: OAuth 【please include your access token】'

-d 'status=%E3%81%8A%E7%96%B2%E3%82%8C%E3%81%95%E3%81%BE%E3%83%BC'
'http://api.mixi-platform.com/2/voice/statuses/update'

29

【For reference】Acquiring an access token

①Register the application and acquire the credential
information of the application
http://developer.mixi.co.jp
②Get authorization from the user. Access using the
browser with the following
http://mixi.jp/connect_authorize.pl?client_id=【include your
Consumer key】
&type=web_server&scope=r_voice w_voice
※This example is for getting authorization for posting and acquiring a mixi
Voice post

If users select“Agree” they are
redirected to the redirect URL of the
application
パラメータ名値
code Authorization code


30

【For reference】Acquiring an access token

③Acquire the access token

curl 'https://secure.mixi-platform.com/2/token'
-d 'grant_type=authorization_code'
-d ‘client_id=【insert Consumer key here】'
-d ‘client_secret=【insert Consumer secret here】'
-d ‘code=【Please insert the Authorization code acquired from step 2】'

-d ‘redirect_uri=【Please include the redirect link here】'

For more information please refer to the following
webpage
http://developer.mixi.co.jp/connect/mixi_graph_api/api_
auth/

An introduction to mixi Graph API

More Related Content

Similar to An introduction to mixi Graph API

Recently uploaded

An introduction to mixi Graph API