XML-RPC Interface

Introduction

Back to the developer docs index

This document contains information on the XML-RPC interface that BLOG:CMS provides, and the error messages it spits out. Please note that the specification of this interface might still undergo changes in the future.

The URL for the BLOG:CMS XML-RPC interface is:
http://www.yourserver.com/yourpath/nucleus/xmlrpc/server.php

The Blogger API (XML-RPC)

BLOG:CMS implements the Blogger API. This allows for tools and services that can communicate with Blogger, to be able to also communicate with BLOG:CMS. Because the way BLOG:CMS works, some interpretations of parameters are slightly different, see the notes below for more info. The structure of method calls and responses are, of course, exactly the same as the methods at Blogger.

Here's the list of available methods. Click them to get more information (links go to either the Blogger API or the Blogger API Mailinglist).

Since BLOG:CMS is structured somewhat differently inside, there are some differences in the way parameters are handled. An overview:

metaWeblog API

Since v1.1, BLOG:CMS also supports the metaWeblog API, which is an extention to the Blogger API.

In BLOG:CMS v2.5, support was added for the newMediaObject and getRecentPosts methods as well (they weren't in the original metaWeblog specification)

A list of available methods is listed below (see the specification for more info):

Movable Type API

Since v2.5, BLOG:CMS supports the methods from the Movable Type API.

The list of available methods is listed below:

Some notes:

Error Codes

Below is an overview of the types of errors you can get back from the methods:

Error Code Error Message
801 Login Error (probably bad username/password combination)
802 No Such Blog
803 Not a Team Member
804 Cannot add Empty Items
805 Amount parameter must be in range 1..20 (getRecentItems)
806 No Such Item
807 Not Allowed to Alter Item
808 Invalid media type
809 File is too large (max. upload filesize)
810 Other error on newMediaObject (message will contain more info about what happened)
other codes < 100 Errors encountered by the Useful Inc. XML-RPC implementation
other codes > 100 Errors encountered by the XML parser