> Using the XML-RPC Server

XML-RPC is "a spec and a set of implementations that allow software running on disparate operating systems, running in different environments to make procedure calls over the Internet. It's remote procedure calling using HTTP as the transport and XML as the encoding. XML-RPC is designed to be as simple as possible, while allowing complex data structures to be transmitted, processed and returned." To use this service, you need to: open an account or login to this site. Configure your XML-RPC client using the information below. All methods on the server require that you give your user login and password (MD5 encoded) as strings in the first two parameters. At this time, there are three methods configured on the server (see samples below): hpe.getSource : retrieve the meta data AND list of news items for a given source. To find an ID for a source, use the source browsing page. hpe.getSourceInfo : retrieve the meta data for a given source. hpe.getSourceItems : retrieve the list of news items for a given source. hpe.searchSources : search for sources which contain a string in their name. hpe.createUser : creates a new user. This site uses the PHP implementation of XML-RPC client and server by useFull Inc. To test the output, use this page.

Host	www.newsisfree.com
Port	80
Path	/RPC

This RPC interface is part Premium Export Service (if you've just opened an account, it's available freely for the first 30 days, it will be disable if you don't sign up before). By using it, you aggree to comply with the Terms of Service.

> Create User

This method creates a new user. It's designed for software writer who wish to integrate NIF's service in their application.

First parameter is your application tag, please contact us to get one;
Second parameter is desired login (should be letters and digits only, not longer the 32 chars);
Third parameter is password (should be letters, digits or [.-_!], 5 to 10 chars);
Fourth parameter is user name;
Fifth parameter is user email;
Sixth parameter is prefered language ('en', 'fr' or 'de').

As with the regular service, the user will receive by email a validation link which needs to be activated before the account can be used. Upon success, method returns true.