ブログサービスからのデータ送信について
以下の文書の正確性や、内容の通りに実行した結果受けたお客様の利益および損害について、弊社はなんらかの保障を行うものではありません。 ご質問はこちらからお寄せください。
概要
ブログ出版局には、ブログサービスのプログラムから直接ブログデータをアップロードするための窓口が用意されています。これを利用することで、ユーザーが手間を省くことができます。
データの送信方法
エンドポイントURL：
/info/if/incomming.php
HTTP multipart/form-data形式(RFC2388)でPOSTしてください。各パラメータはUTF-8でエンコーディングしてください。
※ 以前ご案内していた /2/info/if/incomming.php という旧URLも、後方互換のため引き続きご利用いただけます。新規に実装される場合は、上記の現行URLをお使いください。
ファイル
1つ以上のブログデータファイルを送信する必要があります。ファイルはdata_fileというパラメータ名で送信してください。ZIPで圧縮したファイルも対応しています。複数ファイルの場合はdata_file[]としてください。
基本パラメータ
| パラメータ名 | デフォルト | 説明 |
|---|---|---|
| mode | 1 | 連携モード（"1"、"2"または"3"）。本文レイアウトオプションも同時に送る場合は"3"を指定してください（下記参照）。 |
| encoding | UTF-8 | ブログデータのキャラクタ・エンコーディング（"UTF-8", "EUC-JP", "Shift_JIS", "ISO-2022-JP"） |
| uri | — | ブログURL |
| title | — | ブログの題名 |
| author | — | 著者名 |
| mail_address | — | メールアドレス |
| return | — | ブログサービスへの戻り先URL |
| domain | — | ブログサービス識別用文字列 |
送信後の処理
レスポンスはUTF-8エンコーディングのXML形式で返されます。
エラーの場合：
<?xml version="1.0"?> <response> <error>1</error> <message>[エラーメッセージ]</message> </response>
成功した場合：
<?xml version="1.0"?> <response> <error>0</error> <redirect>[URL]</redirect> </response>
本文レイアウトオプションを同時に送信する場合（mode=3）
データのアップロードと同時に、本文レイアウトオプションもブログ出版局へ送る場合は、modeパラメータに"3"を指定し、以下のパラメータもあわせて送信してください。
共通パラメータ
| パラメータ名 | 必須 | 値の例 | 説明 |
|---|---|---|---|
| title | ○ | ブログ日記 | 本のタイトル |
| description | 日々の出来事 | 本の要約あるいは副題 | |
| author | ○ | ブログ太郎 | 著者の名前 |
| publisher | ブログ出版 | 発行人の名前 | |
| uri | ○ | http://foo.com/miyabe/ | ブログのアドレス |
| include_draft | 1 | 値が"1"のとき、下書きを含める | |
| category | 春<br>夏<br>秋<br>冬 | 改行で区切った、本に含める複数のカテゴリー名 | |
| group_by_category | 1 | 値が"1"のとき、内容をカテゴリー順に並べる | |
| date_begin / date_end | 2002-06-08 | 本にする記事の期間（開始日・終了日） | |
| year_begin / month_begin / day_begin year_end / month_end / day_end | 2002 / 6 / 8 | date_begin / date_endのかわりに、年・月・日を分けて指定することも出来ます | |
| color | 2 | "1"（モノクロ印刷）または"2"（カラー印刷） | |
| fetch_href | 1 | 値が"1"のとき、リンク画像を本に印刷する | |
| make_toc | 1 | 値が"1"のとき、目次を生成する | |
| sp-t-include-comment | 1 | 値が"1"のとき、コメントを印刷する | |
| sp-t-black | 1 | 値が"1"のとき、色指定された文字列を黒にする | |
| super_convert_breaks | 1 | 値が"1"のとき、連続する空行を１つにまとめる | |
| no_breaks_in_paragraphs | 1 | 値が"1"のとき、段落内の改行を除去する | |
| text_style | ○ | v-simple-2 | 本文スタイルの選択（下記参照） |
| mail_address | ○ | miyabe@foo.com | 通知先メールアドレス |
本文スタイル（text_styleの値）
本文スタイル一覧から選択したスタイルのフォルダ名を指定してください（例：v-simple-2, v-2dan-2 等）。スタイルごとの詳細なオプション（フォント、改ページ方法、画像の配置等）は、選択したスタイルによって異なり、随時追加・変更されます。最新の項目・選択肢は本文スタイル一覧の各スタイルの選択画面で直接ご確認ください。
※ フォントの指定コード（sp-t-body-font等）と実際のフォント名の対応は、フォントライセンスの変更等により変わることがあります。実装の際は、事前にお問い合わせの上、最新の対応表をご確認ください。