Movable Type Enterprise 1.5 マニュアル: XML-RPC API

サポートするAPI

サポートしているXML-RPCのメソッドは以下のとおりです。

[blogger.newPost]

機能	新しい投稿を作成し、任意で公開します。
パラメータ	String appkey、String blogid、String username、String password、String content、boolean publish
返り値	成功すると新しい投稿のString postid、失敗するとfault

[blogger.editPost]

機能	既存の投稿についての情報を更新します。
パラメータ	String appkey、String postid、String username、String password、String content、boolean publish
返り値	成功するとtrue、失敗するとfault

[blogger.deletePost]

機能	投稿を削除します。
パラメータ	String appkey、String postid、String username、String password、String content、boolean publish
返り値	成功するとtrue、失敗するとfault

[blogger.getRecentPosts]

機能	システムにおける最新の投稿リストを返します。
パラメータ	String appkey、String blogid、String username、String password、int numberOfPosts
返り値	成功するとISO.8601 dateCreated、String userid、String postid、String contentを含む構造体の配列、失敗するとfault
注:	dateCreatedは、ブログのblogidのタイムゾーンに基づきます。

[metaWeblog.editPost]

機能	既存の投稿についての情報を更新します。
パラメータ	String postid、String username、String password、struct content、boolean publish
返り値	成功するとtrue、失敗するとfault
注:	構造体contentには次の標準のキーを含められます: エントリーのタイトルにはtitle、エントリーの本文にはdescription、エントリー作成日の指定にはdateCreated。 さらにMovable Type Enterpriseの実装によって、次の7つのキーを含め、その値を指定して渡すことができます。 allow_commentsフィールドの値にはint mt_allow_comments、allow_pingsフィールドの値にはint mt_allow_pings、convert_breaksフィールドの値にはString mt_convert_breaks、追記のエントリー・テキストの値にはString mt_text_more、概要のフィールドの値にはString mt_excerpt、キーワード・フィールドの値にはString mt_keywords、このエントリーのトラックバックpingを載せたURLのリストにはarray mt_tb_ping_urls。 dateCreatedを指定する場合は、ISO.8601のフォーマットに従ってください。

[metaWeblog.getPost]

機能	特定の投稿についての情報を返します。
パラメータ	String postid、String username、String password
返り値	成功すると次を含む構造体:String userid、ISO.8601 dateCreated、String postid、String description、 String title、String link、String permaLink、String mt_excerpt、String mt_text_more、int mt_allow_comments、int mt_allow_pings、String mt_convert_breaks、String mt_keywords、失敗するとfault
注:	linkとpermaLinkは共にアーカイブされた投稿を指すURLです。 mt_という接頭語で始まるフィールドは、Movable Type EnterpriseがmetaWeblog.getPost APIを拡張したフィールドです。

[metaWeblog.getRecentPosts]

機能	システムにおける最新の投稿リストを返します。
パラメータ	String blogid、String username、String password、int numberOfPosts
返り値	成功すると次を含む構造体の配列:ISO.8601 dateCreated、String userid、String postid、String description、String title、String link、String permaLink、String mt_excerpt、String mt_text_more、int mt_allow_comments、int mt_allow_pings、String mt_convert_breaks、String mt_keywords、失敗するとfault
注:	dateCreatedは、ブログのblogidのタイムゾーンに基づきます。また、linkとpermaLinkはアーカイブされた投稿を指すURLです。

[metaWeblog.newMediaObject]

機能	ウェブサーバーにファイルをアップロードします。
パラメータ	String blogid、String username、String password、struct file
返り値	アップロードしたファイルへのURL
注:	struct（構造体）fileは次の2つのキーを含んでいるはずです: base64 bits（ファイルのbase64でエンコードされたコンテンツ）およびString name（ファイル名）。 typeキー（ファイルのメディア・タイプ）は現在、無視されています。

[mt.getRecentPostTitles]

機能	システムにおける最新の投稿を載せた必要最小限のリストを返します。
パラメータ	String blogid、String username、String password、int numberOfPosts
返り値	成功すると、ISO.8601 dateCreated、String userid、 String postid、String titleを含む構造体の配列、失敗するとfault
注:	dateCreatedは、ブログのblogidのタイムゾーンに基づきます。

[mt.getCategoryList]

機能	ブログに定義された全カテゴリーのリストを返します。
パラメータ	String blogid、String username、String password
返り値	成功するとString categoryIdとString categoryNameを含む構造体の配列、失敗するとfault

[mt.getPostCategories]

機能	投稿されたエントリーに割り当てた全カテゴリーのリストを返します。
パラメータ	String postid、String username、String password
返り値	成功するとString categoryName、String categoryId、およびboolean isPrimaryを含む構造体の配列、失敗するとfault
注:	isPrimaryはカテゴリーがその投稿されたエントリーのメイン・カテゴリーに属すかどうかを表示します。

[mt.setPostCategories]

機能	投稿されたエントリーにカテゴリーを指定します。
パラメータ	String postid、String username、String password、array categories
返り値	成功するとtrue、失敗するとfault
注:	array categoriesは、String categoryIdとboolean isPrimary含む構造体の配列です。メイン・カテゴリーを指定するためのisPrimaryはオプションです。このフラグがないと、arrayの最初の構造体が投稿されたエントリーのメイン・カテゴリーに割り当てられます。

[mt.supportedMethods]

機能	サーバーがサポートするXML-RPCメソッドについての情報を取得します。
パラメータ	なし
返り値	サーバーがサポートするメソッド名の配列

[mt.supportedTextFilters]

機能	サーバーがサポートするテキスト・フォーマットのプラグインについての情報を取得します。
パラメータ	なし
返り値	String keyとString labelを含む構造体の配列。keyはテキスト・フォーマットのプラグインを特定する固有な文字列で、labelはユーザーに表示される説明です。keyはmt_convert_breaksのパラメータとしてnewPostとeditPostに渡される値です。

[mt.getTrackbackPings]

機能	特定のエントリーに投稿されたトラックバックpingのリストを取得します。このメソッドは、特定のエントリーに送られたpingのリストをプログラミングによって取得し、特定のトピックに対し互いに参照し合うエントリー群のウェブグラフを作り上げるまで、リストで得られたpingを次々に反復動作処理するときに使用することもできます。
パラメータ	String postid
返り値	次を含む構造体の配列:String pingTitle（pingによって送られたエントリーのタイトル）、String pingURL（エントリーのURL）、およびString pingIP（pingを送ったホストのIPアドレス）

[mt.publishPost]

機能	1つのエントリーに関連したスタティック・ファイルをすべて、ブログから公開（再構築）します。エントリーをシステムに保存することと同じですが、pingを送信しないところが異なります。
パラメータ	String postid、String username、String password
返り値	成功するとtrue、失敗するとfault

注意 Movable Type Enterpriseでは、Blogger XML-RPCのメソッドすべてにおいてappkeyの値は無視されます。