ブログ出版局サポートサイト

処理の流れ

ブログ本文データに加え、本文レイアウトオプションをブログサービスから送信する場合、mode2/3の二通りの方法があります。mode2は、従来のmode1のデータの流れを踏襲しており、mode1からの移行が簡単です。これから実装される場合は、mode3をご利用下さい。

レイアウトオプションをフォームで送信する場合(mode=2)

まずブログサービスからブログ出版局にデータをアップロードします。
そのとき、modeパラメータに"2"を設定すると、以下の形式のレスポンスの[URL]の部分が、本文レイアウトオプションの送信先アドレスとなります。

<?xml version="1.0"?>
<response>
<error>0</error>
<redirect>[URL]</redirect>
</response>

[URL]を取得した後、利用者に対して、例えば次のようなフォームを表示し、利用者のブラウザから直接、レイアウトオプションをブログ出版局へ送信してください。

<form method="post" action="[URL]">
<p>タイトル: <input type="text" name="title" value="" /></p>
<p>副題: <textarea name="description"></textarea></p>
...
<button type="submit">見本PDFを作成</button>
</form>

レイアウトオプションと共にuri, title, author, mail_addressパラメータもフォームから送る必要があります。そのため、サーバーからのデータのアップロード時には、送信可能なこれらのパラメータを送る必要はありません。

利用者がフォームから送信すると、パラメータに不備がなければ、見本PDF作成の進行状況が表示され、処理はブログ出版局に引き継がれます。パラメータに不備がある場合、通常はブログ出版局のデータ登録ページに転送され、エラーメッセージが表示されます。送信元のブログサービスのフォームに戻る場合は、on_errorという名前のパラメータ名にアドレスを設定しておくと、エラー発生時にそのアドレスにリダイレクトされます。

ブログサービスのサーバーから全てのデータを一度に送信する場合(mode=3)

ブログサービスからブログ出版局にデータをアップロードする際、modeパラメータに"3"を設定すると、　http://print.cssj.jp/2/info/if/incomming.php　に対して、ブログデータとレイアウトオプションを
一度に送ることが出来ます。送信後の処理方法はmode=1の場合と同じで、移動先のページは見本PDF作成の進捗状況表示になります。

パラメータ一覧

以下が、レイアウトオプションを設定するためのパラメータの一覧です。

共通のパラメータ

※year_XXX, month_XXX, day_XXXのパラメータは３つで１組です。どれか１つが欠けている場合は、全て省略されたと見なされます。

mode=2 で有効なパラメータ

mode=3 で有効なパラメータ

本文スタイル

text_styleは本文のスタイル名です、設定可能な値は以下の表のとおりです（本文スタイルは他にもありますが、推奨されるものだけ掲載しています）。

各本文スタイルには、さらに特有のパラメータがあります。以下の表から設定してください。

本文スタイルのパラメータ

各本文スタイルのパラメータはsp-t-XXXという形をしています。全てのパラメータは省略可能で、デフォルト値が存在します。

フォントを指定するパラメータは、このページの最後の、パラメータ値とフォントの対応表の値を使ってください。

standard-2 （新・標準スタイル（横組））

group_by_categoryパラメータが"1"の場合は、カテゴリー名により章立てされます。

v-simple-2 （標準縦組）およびv-2dan-2（縦二段組）

group_by_categoryパラメータが"1"の場合は、カテゴリー名により章立てされます。

パラメータ値とフォントの対応表

※字面が崩れることがあるため、IPAフォントを縦書きで使用しないでください。

概要

ブログ出版局には、ブログサービスのプログラムから直接ブログデータをアップロードするための窓口が用意されています。 これを利用することで、ブログサービスのユーザーが一旦ブログデータファイルをダウンロードしてブログ出版局にアップロードする、という手間を省くことができます。

実装例としてMovableType 4向けのプラグインが用意されています。

データの送信方法

以下のアドレスにHTTP multipart/form-data形式(RFC2388)でPOSTしてください。各パラメータはUTF-8でエンコーディングしてください（ブログデータ本体を除く）。

http://print.cssj.jp/2/info/if/incomming.php

ファイル

必ず１つ以上のブログデータファイルを送信する必要があります。

ファイルは data_file というパラメータ名で送信してください。

ZIPで圧縮したファイルを送ることもできます。 Content-Typeがapplication/zipであるか、ファイル名が.zipで終わる場合ZIPファイルと認識されます。

複数のファイルを送る場合はパラメータ名を data_file[] としてください。 なお、ZIPファイルを複数送ること、ZIPファイルとZIP形式以外のファイルを混ぜて送ることはできません。

パラメータ

以下のパラメータを適宜加えてください。パラメータはいずれも省略可能です。

encodingはブログデータのキャラクタ・エンコーディングをブログ出版局が正しく認識するためのものです。 
uri, title, author, mail_addressは、ブログ出版局の見本作成ページで、最初から入力された状態にするためのものです。省略した場合は空欄になるか、あるいはCookieに保持されたデータから以前の入力が復元されます。

見本PDFが作成された時、あるいはエラー発生時にデータを再登録するためのページへのリンクがお客様に案内されますが、通常はブログ出版局の見本作成ページに誘導されます。ブログシステムの管理画面など、別のページに誘導したい場合は、returnパラメータにそのページのURLを入れておいてください。

domainはアフィリエイト等のために、呼び出し元ブログサービスを弊社が識別できるようにするためのものです。通常は、ブログサービスのドメイン名(foo.com等)を入れてください。

modeは、省略するか"1"の場合はブログ出版局のサイトで、利用者がレイアウトオプションを設定します。modeを"2"または"3"に設定すると、ブログサービス側で本のレイアウトオプションの設定画面を用意することが出来ます。詳細は、本文レイアウトオプションの送信の解説をご覧下さい。

送信後の処理

ファイルの送信後、ブログ出版局側の処理結果はUTF-8エンコーディングのXML形式で返されます。 POSTに対するレスポンスは以下のいずれかです。

エラーの場合

<?xml version="1.0"?>
<response>
<error>1</error>
<message>[エラーメッセージ]</message>
</response>

エラーの場合、ブログサービスは[エラーメッセージ]の内容をユーザーに表示してください。

成功した場合

<?xml version="1.0"?>
<response>
<error>0</error>
<redirect>[URL]</redirect>
</response>

成功した場合、ブログサービスはリダイレクト等の手段で[URL]のアドレスに利用者を誘導してください。

multipart/form-dataの実装に関する情報

HTML

手っ取り早くテストする場合は、次のようなHTMLファイルを用意し、手元のブラウザで表示してください。

<form action="http://print.cssj.jp/2/info/if/incomming.php"
    method="post" enctype="multipart/form-data">
    mode: <input type="text" name="mode" value="1" />
    encoding: <input type="text" name="encoding" value="UTF-8" /><br />
    data_file: <input type="file" name="data_file" /><br />
    <button type="submit">送信</button>
</form>

Perl

LWP::UserAgentが利用できます。

MovableType 4向けのプラグインは実際このライブラリを使っています。プラグインに含まれるlib/PrintCSSJ.pmのコードを流用して頂いても構いません。

PHP

PEAR HTTP_Requestが利用できます。

Java

Apace HTTP Clientを利用できます。

その他

cURLをコマンドラインで実行する方法があります。

ここではブログサービス開発者のために、ブログ出版局に関する技術文書等を公開しています。 以下の文書の正確性や、内容の通りに実行した結果受けたお客様の利益および損害について、弊社はなんらかの保障を行うものではありません。 技術文書についてのコメントはこちらからお寄せください。

システム連携機能

ブログサービス会社等から、ブログ出版局へ直接データを送信していただく方法の解説です。

ブログサービスからブログ出版局へのデータのアップロード方法

本文レイアウトオプションの送信
（本文レイアウトの設定を、ブログサービス会社等のサイトで行う場合）

ブログ出版局がサポートするデータ形式

ブログ出版局が書籍化することができる、ブログ記事のエクスポート形式についての解説です。