MyBooks.jp連携インタフェース(体験版)のご利用について
【利用条件】
- この体験版インターフェースを利用して貴社のブログをMyBooks.jpに連携させることができます。法人様であれば商用/非商用とわずどなたでもご利用いただくことができます。
【制限事項】
- この体験版インターフェースを利用して作成されたPDFファイルの印刷・製本のご注文は可能ですが、アフィリエイトプログラムは適用されません。
【免責事項】
- このインターフェース仕様は体験版であり、何の予告なしに仕様を変更する場合や、公開を中止する場合があります。
- 貴社のインターフェースをこの体験版インターフェース仕様に適合させるために発生する費用等について、MyBooks.jpは一切の責任を負いません。
- 貴社のインターフェースを体験版インターフェース仕様に適合させた後に、MyBooks.jpが体験版インターフェース仕様を変更したために貴社のインターフェースの修正が発生した場合について、MyBooks.jpは一切の責任を負いません。
- 貴社のインターフェースに適合するように、この体験版インターフェース仕様をMyBooks.jpが変更する一切の責任を負いません。
- 体験版インターフェースを利用したことで、貴社および第三者に対して何らかの損害が発生しても、MyBooks.jpは一切の責任を負いません。
ご利用方法
MyBooks.jpでPDFを作成する場合、貴社(連携サイト様)は、パラメーターを設定してMyBooks.jpが準備する連携ログインURLを呼び出していただきます。必要なパラメーターは、以下の3つです。
- MTファイルを特定するID (連携サイト様で作成)
- 体験用連携サイトID(1217)
- MTファイル取得URL
MyBooks.jpはこのMTファイルIDをパラメーターに設定して、連携サイトのMTファイル取得URLを呼び出してMTファイルをダウンロードします。(MyBooks.jpは、RequestとResponseでMTファイルを取得します。)
- MTファイルの取得 (貴社(連携サイト側)で事前に準備してください)
MTファイルIDをmtidパラメーターに設定してください。MyBooks.jpはMTファイルを取得するため、このURLを呼び出します。MTファイルIDは連携サイト様で作成してください。
http://www.abc.jp/xxxxx?mtid=xxxxx
(パラメーター無しのURLを上記のmturlに設定してください。)
【パラメーター】
- mtid: 連携サイトでアサインされたMTファイルID
【処理内容】
ここで設定するmtidは、連携ログインURLのmtidパラメーター値と同じIDです。
連携サイトは、該当するMTファイルを、文字化けを避ける為にバイナリーでレスポンスに書き込んでください。(MTファイルはテキストである必要がありますが、UTF-8, Shift-JIS, JIS, EUC等の文字コードの可能性があるので、ResponseのBinaryWriteメソッドを使用してください。)出来れば、UTF-8でお願いします。(UTF-16はサポートしていません。)
- MyBooks.jpの連携ログインURL
連携サイト経由でMyBooks.jpへ入るためのエントランスです。
https://mybooks.jp/affiliatelogin.aspx?sid=1217&mtid=xxxxx&mturl=abc@xxxx.jp
【パラメーター】
- sid: サイトIDは1217を設定します。
- mtid: 連携サイトでアサインされたMTファイルID
- mturl: 下記のMTファイル取得URL
【処理内容】
有効な連携サイトIDかどうか、MTファイルが存在しているかどうかなどのチェックを行います。正しくない場合はエラーを表示します。MTファイルの取得に成功すると、MyBooks.jpは、MTファイルIDをクッキーに保存し、ログイン画面を表示します。ログイン後は、MyBooks.jp本来の処理に移ります。
連携サイト経由で作成されたPDFは、そのことを示す為のフラグを設けデーターベースに保存します。
未登録のユーザーは、MyBooks.jpに新規登録を行っていただきます。
簡単なサンプル(C#)
public partial class MTContentFeed : System.Web.UI.Page
{
if (!this.Page.IsPostBack)
{
string mtid = Request.Params.Get("mtid");
StringBuilder mtArticles = new StringBuilder();
// mtidに該当するMTファイルの内容をArticlesに追加
// mtArticles.Append(MTファイルの内容);
if (mtArticles.Length > 0)
{
Response.AddHeader("Content-Disposition", "attachment;filename=xxxxx.txt");
Response.ContentType = "text/plain";
Response.Write(mtArticles.ToString());
Response.Flush();
Response.End();
}
}
}
お問い合わせ
ご不明な点はこちらの
問い合わせフォームからお問い合わせください。
お問い合わせの種類は「その他」をチェックしてください。