Voice API

APIのURI
種類 操作 メソッド URL
つぶやき
(statuses)
つぶやきの投稿 POST /voice/statuses/update
友人のつぶやき一覧の取得 GET /voice/statuses/friends_timeline
特定ユーザーのつぶやき一覧の取得 GET /voice/statuses/User-ID/user_timeline
特定のつぶやきの情報取得 GET /voice/statuses/show/Post-ID
つぶやきの削除 POST /voice/statuses/destroy/Post-ID
コメント
(replies)
コメントの投稿 POST /voice/replies/create/Post-ID
コメントの取得 GET /voice/replies/show/Post-ID
コメントの削除 POST /voice/replies/destroy/Post-ID/Comment-ID
イイネ!
(favorites)
イイネ!の投稿 POST /voice/favorites/create/Post-ID
イイネ!の削除 POST /voice/favorites/destroy/Post-ID/User-ID

エラー

リクエストに失敗した場合には、

{"error":"unknown error. code:404"}

のようなJSON形式でエラーが返されます。

つぶやきの投稿

POST https://api.mixi-platform.com/2/voice/statuses/update

のURLに対して、URLエンコードされたテキストをstatusパラメータとしてPOSTします。

投稿に成功した場合には、特定のつぶやきを取得した結果と同様の形式でつぶやいた内容が返されます。

つぶやきの文字数が制限 (150文字) を超えたり、不正なパラメータを指定したときには、HTTPヘッダで「400 Bad Request」が返されます。

フォト付きつぶやきの投稿

サポートされる画像フォーマットは、

  • JPG
  • PNG

の2種類です。それ以外の画像を投稿したときには「400 Bad Request」で{"error":"unknown error. code:400"}返されます。

リクエストのContent-Type
フォト Content-Type
なし application/x-www-form-urlencoded
あり multipart/form-data

つぶやきの取得

友人のつぶやき一覧の取得

GET https://api.mixi-platform.com/2/voice/statuses/friends_timeline/Group-ID

mixiの最新のつぶやきの内容を取得できます。ドキュメントでは友人のつぶやきを取得すると解説されていますが、返されるデータには自分のつぶやきも含まれます。

パラメータ 説明
Group-ID グループのID
since_id results_directionの起点となるID
results_direction since_idを起点とした、取得するつぶやきの種類
  • next … 古いのつぶやき
  • previous … 新しいつぶやき (既定値)
count 取得件数の上限。既定値は20で、最大値は200。
trim_user "true"とすると、ユーザー情報としてidだけ返される。"exclude_screen_name"とすると、idとscreen_nameだけが返される。
attach_photo "true"とすると、つぶやきに含まれるフォト情報をphotoプロパティとして抜き出す
※ すべてのパラメータは省略可。

Group-ID

https://api.mixi-platform.com/2/voice/statuses/friends_timeline/%40topFriends?count=1
Group-IDあり
https://api.mixi-platform.com/2/voice/statuses/friends_timeline/?count=1
Group-IDなし

特定ユーザーのつぶやき一覧の取得

GET https://api.mixi-platform.com/2/voice/statuses/User-ID/user_timeline

User-IDを「@me」とすると、mixiの自分のつぶやきの内容が返されます。

特定のつぶやきの情報取得

GET https://api.mixi-platform.com/2/voice/statuses/show/Post-ID

取得結果

属性名 説明
id つぶやきを特定するためのID (Post-ID)
created_at 投稿日時
text つぶやきの本文
user 投稿したユーザーの情報
reply_count コメントの件数
favorite_count イイネ!の件数
source このつぶやきがTwitterから取り込まれた場合に含まれる。そのときの値は"twitter"。
favorited 認可ユーザーがこのつぶやきに"イイネ!"している場合にtrue。さもなくばfalse。
photo つぶやきに含まれるフォト情報

(この情報を取得するには、リクエスト時にattach_photo=trueとする必要がある)

user
属性名 説明
id ユーザーID
screen_name ユーザーのニックネーム
profile_image_url ユーザーのプロフィール画像のURL
url※1 ユーザーのプロフィールページのURL
http://mixi.jp/show_friend.pl?uid=id
の形式で、idはユーザーID。
※1 urlは、そのユーザーが認可ユーザーと友人関係の場合のみ含まれます。

urlとprofile_image_urlのURLについては、URLのルール << mixi Developer Centerに詳細があります。

photo
属性名 説明
image_url フォトのURL
thumbnail_url フォトのサムネイルのURL
つぶやきID (Post-ID)

つぶやきのIDは、つぶやきを投稿したユーザーのIDと投稿日時により決定されます。たとえば、

  • ユーザーID … "abc"
  • 投稿日時 … "2010/01/02 3:40:50"

ならば、つぶやきIDはそれらを連結して"abc-20100102034050"となります。

ユーザーID
  URL
プロフィール情報
http://mixi.jp/show_profile.pl?id=旧ユーザーID
 
http://mixi.jp/show_friend.pl?id=旧ユーザーID
【重要】mixiアプリAPIのユーザーID仕様変更に関するお知らせ << mixi Developer Center

つぶやきの削除

POST https://api.mixi-platform.com/2/voice/statuses/destroy/Post-ID

削除に成功した場合には、削除したつぶやきの内容が返されます。

コメントの投稿

POST https://api.mixi-platform.com/2/voice/replies/create/Post-ID

コメントの取得

GET https://api.mixi-platform.com/2/voice/replies/show/Post-ID

取得結果

属性名 説明
id コメントを特定するためのID (Comment-ID)
created_at 投稿日時
text コメントの本文
user 投稿したユーザの情報

(つぶやきのuserプロパティに同じ)

コメントID (Comment-ID)

コメントIDは、コメントしたつぶやきのIDとコメントしたユーザーのID、およびその投稿日時により決定されます。たとえば、

  • つぶやきID … "abc-20100102034050"
  • コメントしたユーザーのID … "def"
  • コメントした日時 … "2010/02/03 3:40:50"

ならば、コメントIDはそれらを連結して"abc-20100102034050-def-20100203034050"となります。

イイネ!の投稿

POST https://api.mixi-platform.com/2/voice/favorites/create/Post-ID

取得結果

投稿の成否は、レスポンスのHTTPヘッダで確認できます。

レスポンス
ステータス 状況
200 OK 投稿に成功した。このとき、イイネ!を投稿したつぶやきの情報が返される。
401 Authorization Required 認可が得られていない。
403 Forbidden すでにイイネ!を投稿してあるつぶやきに再度イイネ!の投稿を行った、または認可されないユーザーのつぶやきにイイネ!を投稿した。
413 Request Entity Too Large リクエストボディの指定に誤りがある。
※ 「Content-Length: 0」となるように空のデータを指定する必要がある。

投稿に成功した場合のみレスポンス ボディが返され、それはイイネ!を投稿したつぶやきの情報となっています。そこにはイイネ!の件数を表すfavorite_countも含まれますが、その件数にはこの投稿は含まれません。