

We also wanted it to be an easy to implement protocol that could quickly be adapted to run in other environments or on other operating systems. It should be possible for an HTML coder to be able to look at a file containing an XML-RPC procedure call, understand what it's doing, and be able to modify it and have it work on the first or second try.Įasy to implement. We wanted a clean, extensible format that's very simple.
#Xml rpc marsedit software#
Firewall software can watch for POSTs whose Content-Type is text/xml.ĭiscoverability.

The goal of this protocol is to lay a compatible foundation across different environments, no new power is provided beyond the capabilities of the CGI interface. The could also contain a which contains a which is a containing two elements, one named, an and one named, a. The body of the response is a single XML structure, a, which can contain a single which contains a single which contains a single. Content-Length must be present and correct. Unless there's a lower-level error, always return 200 OK. Here's an example of a response to an XML-RPC request: HTTP/1.1 200 OK S can be recursive, any value may contain an or any other type, including a, described above. You can mix types as the example above illustrates. Here's an example of a four-element array: sĪn contains a single element, which can contain any number of s. S can be recursive, any may contain a or any other type, including an, described below. If no type is indicated, the type is string. S can be scalars, type is indicated by nesting the value inside one of the tags listed in this table: Tagĭouble-precision signed floating point number The sub-item can contain any number of s, each of which has a. If the procedure call has parameters, the must contain a sub-item. Or it could be a path to a file contained within a hierarchy of folders and files. It could be the name of a cell in a database table.
#Xml rpc marsedit how to#
It's entirely up to the server to decide how to interpret the characters in a methodName.įor example, the methodName could be the name of a file containing a script that executes on an incoming request. The string may only contain identifier characters, upper and lower-case A-Z, the numeric characters, 0-9, underscore, dot, colon and slash. The must contain a sub-item, a string, containing the name of the method to be called. The payload is in XML, a single structure. The Content-Length must be specified and must be correct. (In the example, the URI is /RPC2, telling the server to route the request to the "RPC2" responder.)
#Xml rpc marsedit code#
However, if the server is handling a mix of incoming HTTP requests, we allow the URI to help route the request to the code that handles XML-RPC requests. For example, it could be empty, a single slash, if the server is only handling XML-RPC calls. The format of the URI in the first line of the header is not specified. Here's an example of an XML-RPC request: POST /RPC2 HTTP/1.0 and can also be complex record and list structures. Procedure parameters can be scalars, numbers, strings, dates, etc. A procedure executes on the server and the value it returns is also formatted in XML. XML-RPC is a Remote Procedure Calling protocol that works over the Internet.Īn XML-RPC message is an HTTP-POST request. This page provides all the information that an implementor needs. This specification documents the XML-RPC protocol implemented in UserLand Frontier 5.1.įor a non-technical explanation, see XML-RPC for Newbies.
