mixi Connect » mixi Plugin » SimplePost » 技術仕様
技術仕様
SimplePostはmixi上の様々なコンテンツの投稿・申請画面を、初期内容を指定した状態で表示することができる統一的なインタフェースです。WebサイトにSimplePostボタンを配置していただくことで、mixiユーザは多くのコンテンツを友人とシェアすることができるようになります。
この文書では、SimplePostの仕様と利用方法について説明します。
できること
SimplePostのエンドポイントに対し、後述する仕様に沿ったリクエストを与えることで、ボイス投稿、日記投稿、メッセージ送信、カレンダー登録を行う画面や、お気に入り追加、友人申請などを行う画面を、あらかじめ指定した内容が入力された状態で表示させることができます。
SimplePostはパートナー登録不要で利用できます。また、プログラミングを必要とせず、HTMLの知識のみで実装することができます。
mixiConnectやmixiアプリAPIを使用しないシチュエーションにおいて、簡易的なmixiとのサービス連携を実現することが可能です。
認証
現在、SimplePostはPC版mixi及びmixi Touchでご利用頂けます。
SimplePostは、PC版mixiにおいてはPC版mixiへのリダイレクタ、mixi Touchにおいてはmixi Touchのリダイレクタとして機能します。よって、通常のログインと同様にCookieによるログイン認証を行います。
また、mixiへのログインを行っていない状態でSimplePostを呼び出した場合は、通常のmixiへのログイン操作を行った後で、指定された内容を含む投稿画面を表示します。
制限
SimplePostはGETメソッドでパラメータを引き継ぎ画面を遷移しますので、ブラウザが解釈できるURLの最大長の制限に影響を受けます。
URLの長さは1500byte以内に収めていただくことを推奨します。
SimplePostのエンドポイント
SimplePostは、下記のエンドポイントに対し、仕様に規定されたクエリパラメータを与えることで利用することができます。
サービス識別子はdiaryやmessageといった、サービスを表す文字列となります。
SimplePostエンドポイント
https://mixi.jp/simplepost/[サービス識別子]?[リクエストパラメータ]
表示に使用する初期内容は、クエリパラメータによって指定します。
受け付けるクエリパラメータの種類は、仕様を参考にしてください。
クエリパラメータは通常のURLににおける指定と同様に、GETメソッド、および、POSTメソッドによって指定することができます。
クエリパラメータとして指定可能なエンコード形式はutf8とします。
例として、GETメソッドによりパラメータを指定し、日記投稿画面を表示する場合は以下のようなURLとなります。
日記投稿画面を表示するサンプル
https://mixi.jp/simplepost/diary?title=hello&body=world
つぶやきの投稿
ボイスのつぶやき投稿画面を初期内容を指定した状態で表示します。
外部サービスから、紹介したい内容・文面を使ってユーザにつぶやきを投稿して共有してもらう際などに有効です。
サービス識別子は「voice」となります。
エンドポイント
https://mixi.jp/simplepost/voice
受け付けるクエリパラメータ
| パラメータ名 | 説明 | データ形式 |
|---|---|---|
| status | ボイス本文 | 文字列・全角150文字まで |
使用例およびサンプル
<a href="https://mixi.jp/simplepost/voice?status=%e3%81%82%e3%82%84%e3%81%93%e3%81%95%e3%82%93%e3%82%92%e5%8b%95%e7%89%a9%e3%81%a7%e4%be%8b%e3%81%88%e3%82%8b%e3%81%a8%e3%80%8c%e3%83%a9%e3%82%af%e3%83%80%e3%80%8d%e3%82%bf%e3%82%a4%e3%83%97%e3%81%a7%e3%81%99%ef%bc%81"><img src="http://img.mixi.net/img/basic/mixicheck_entry/bt_voice_1.png" /></a>
※実際の使用時には、あらかじめ投稿内容をutf8にエンコードして指定することを推奨します。
日記の投稿
日記の投稿画面を初期内容を指定した状態で表示します。
外部サービスやmixiアプリなどから、紹介したい内容・文面を使ってユーザに日記を書いてもらう際などに有効です。
サービス識別子は「diary」となります。
エンドポイント
https://mixi.jp/simplepost/diary
受け付けるクエリパラメータ
| パラメータ名 | 説明 | データ形式 |
|---|---|---|
| title | 日記タイトル | 文字列・全角100文字まで |
| body | 日記本文 | 文字列 |
使用例およびサンプル
<a href="https://mixi.jp/simplepost/diary?title=%e3%81%a9%e3%81%86%e3%81%b6%e3%81%a4%e8%a8%ba%e6%96%ad&body=%e3%81%82%e3%82%84%e3%81%93%e3%81%95%e3%82%93%e3%81%af%e3%80%8c%e3%83%aa%e3%83%a3%e3%83%9e%e3%80%8d%e3%82%bf%e3%82%a4%e3%83%97%e3%81%a7%e3%81%99%ef%bc%81"><img src="http://img.mixi.net/img/basic/mixicheck_entry/bt_diary_1.png" /></a>
※実際の使用時には、あらかじめ投稿内容をutf8にエンコードして指定することを推奨します。
メッセージの送信
メッセージの送信画面を初期内容を指定した状態で表示します。
ユーザ自身のウェブサイトやブログ等に、mixiメッセージの送信リンクなどを設置する際や、
mixiアプリにメッセージ送信機能を追加する際に有効です。
サービス識別子は「message」となります。
エンドポイント
https://mixi.jp/simplepost/message
受け付けるクエリパラメータ
| パラメータ名 | 説明 | データ形式 |
|---|---|---|
| id | 送信先メンバーID | 整数値 |
| subject | 件名 | 文字列・全角100文字まで |
| body | メッセージ本文 | 文字列 |
使用例およびサンプル
<a href="https://mixi.jp/simplepost/message?subject=%e7%84%bc%e8%82%89%e5%a4%a7%e4%bc%9a%e3%81%8a%e8%aa%98%e3%81%84&body=%e3%81%9c%e3%81%b2%e3%81%8a%e6%b0%97%e8%bb%bd%e3%81%ab%e3%81%94%e5%8f%82%e5%8a%a0%e3%81%8f%e3%81%a0%e3%81%95%e3%81%84%ef%bc%81"><img src="http://img.mixi.net/img/basic/mixicheck_entry/bt_message_1.png" /></a>
※実際の使用時には、あらかじめ投稿内容をutf8にエンコードして指定することを推奨します。
予定の作成
カレンダーの予定作成画面を初期内容を指定した状態で表示します。
外部のイベント告知サイトや予定調整サイト、mixiアプリなどから、予定の作成をユーザに促す際などに有効です。
サービス識別子は「schedule」となります。
エンドポイント
https://mixi.jp/simplepost/schedule
受け付けるクエリパラメータ
| パラメータ名 | 説明 | データ形式 |
|---|---|---|
| title | イベント名 | 文字列・全角100文字まで |
| body | イベント説明 | 文字列 |
| year | 開催候補日（年） | 整数値・今年および来年を表す4ケタの数字 |
| month | 開催候補日（月） | 整数値・1～12の数字 |
| day | 開催候補日（日） | 整数値・1～当月の最終日までの数字 |
| hour | 開催候補日（時） | 整数値・0～24までの2ケタの数字 |
| minute | 開催候補日（分) | 整数値・0,15,30,45のみ |
| recruit | 募集を行うかどうか | 整数値・1...募集する／0...募集しない |
| invite | 招待する友人のリスト | 文字列・招待する友人のIDをカンマ句切りで指定(1234,5678のように) |
使用例およびサンプル
<a href="https://mixi.jp/simplepost/schedule?title=%e3%82%af%e3%83%aa%e3%82%b9%e3%83%9e%e3%82%b9%e3%83%94%e3%82%a2%e3%83%8e%e3%82%b3%e3%83%b3%e3%82%b5%e3%83%bc%e3%83%88&body=%e5%85%a5%e5%a0%b4%e6%96%99%e3%81%af%e7%84%a1%e6%96%99%e3%81%a7%e3%81%99%e3%80%82%e3%81%9c%e3%81%b2%e3%81%94%e5%8f%82%e5%8a%a0%e3%81%8f%e3%81%a0%e3%81%95%e3%81%84%ef%bc%81&year=2010&month=12&day=24&hour=20&minute=30&recruit=1"><img src="http://img.mixi.net/img/basic/mixicheck_entry/bt_schedule_1.png" /></a>
※実際の使用時には、あらかじめ投稿内容をutf8にエンコードして指定することを推奨します。
お気に入りへの追加
指定したユーザをお気に入り（旧「マイリスト」）へ追加する画面を表示します。
サービス識別子は「mylist」となります。
エンドポイント
https://mixi.jp/simplepost/mylist
受け付けるクエリパラメータ
| パラメータ名 | 説明 | データ形式 |
|---|---|---|
| id | お気に入りに追加する対象のメンバーID | 整数値 |
使用例およびサンプル
<a href="https://mixi.jp/simplepost/mylist?id=member_id"><img src="http://img.mixi.net/img/basic/mixicheck_entry/btn_mylist_1.png" /></a>
※実際の使用時には、あらかじめ投稿内容をutf8にエンコードして指定することを推奨します。
※実際には動作しません。member_idを置き換えてください。
友人申請
指定したユーザに友人申請する画面を表示します。
サービス識別子は「friendRequest」となります。
エンドポイント
https://mixi.jp/simplepost/friendRequest
受け付けるクエリパラメータ
| パラメータ名 | 説明 | データ形式 |
|---|---|---|
| id | 友人申請する対象のメンバーID | 整数値 |
使用例およびサンプル
<a href="https://mixi.jp/simplepost/friendRequest?id=member_id"><img src="http://img.mixi.net/img/basic/mixicheck_entry/bt_friend_1.png" /></a>
※実際の使用時には、あらかじめ投稿内容をutf8にエンコードして指定することを推奨します。
※実際には動作しません。member_idを置き換えてください