XOBJEX SERVICE REGISTRY

XOBJEX::Registrar

A web service used to register the location and API documentation of other web services. XOBJEX::Registrar exposes the following functions:

register

The register function takes one parameter, the URL of the service and returns an XML graph:

registration
- key
- event
- link

The value of the element 'key' is the required parameter for the 'unregister' function. The service CANNOT be unregistered without the 'key'.

The registered service must return an 'rss-info' element with populated child elements 'title', 'link', and 'description' (i.e. an RSS item) for the service registration to have any distributive or public value.

unregister

The 'unregister' function also takes one parameter, 'key', which is the return value of the 'register' function. With the correct key value, the service is removed from the registry.

A call to XOBJEX::Registrar would look like these examples:

http://xobjex.com/service/registrar.xsl?register=http://webservices.com/servicename.jsp

http://xobjex.com/service/registrar.xsl?unregister=Qcd70kBR6d0AAB0EfAQ

Contact dan@xobjex.com for support. See other REST Services at: http://xobjex.com/services/

XOBJEX::Date

A web service that provides individual components of a date and time like year, month, day, hour, minute, and second as well as an ISO 8601 compliant date/time stamp (extended format) in the form of an XML graph.

XOBJEX::Date takes one optional parameter, 'offset', the value of which must be in the form "+/-00:00" from UTC. For example:

Los Angeles - http://xobjex.com/service/date.xsl?offset=-08:00
New York - http://xobjex.com/service/date.xsl?offset=-05:00
Sydney - http://xobjex.com/service/date.xsl?offset=+11:00

Contact dan@xobjex.com for support. See other REST Services at: http://xobjex.com/services/

XOBJEX::Resolver

A web service that resolves the name of a web service listed in the XOBJEX Service registry to a callable URL. The return value is an XML Element named 'link' with text or value being the URL of the web service. If the name does not resolve, the link element is not returned. XOBJEX::Resolver takes one parameter, 'resolve', the value of which is the case-sensitive name of the service you want the URL. For example: http://xobjex.com/service/resolver.xsl?resolve=XOBJEX::Date

Contact dan@xobjex.com for support. See other REST Services at: http://xobjex.com/services/

XOBJEX::IDGenerator

A web service that produces a unique id (UID) per HTTP request. This service also generates a localized UID in the form 'hostname:uid' and a transactional UID in the form 'caller.ip.address@hostname:uid'. XOBJEX::IDGenerator uses Apache's mod_unique_id to generate the UID.

Contact dan@xobjex.com for support. See other REST Services at: http://xobjex.com/services/

XOBJEX::AreaCode2State

A web service that given a specified U.S. Telephone Area Code returns the U.S. State to which the Area Code belongs. For example: http://xobjex.com/service/ac2state.xsl?ac=310 will return "California" in an XML graph.

Contact dan@xobjex.com for support. See other REST Services at: http://xobjex.com/services/

XOBJEX::GeoIP

A web service that given a specified IP Address returns the name of the country to which the IP Address has been assigned. For example: http://xobjex.com/service/geoip.xsl?ip=64.90.191.110 will return "United States" in the country attribute of the address element in an XML graph.

Contact dan@xobjex.com for support. See other REST Services at: http://xobjex.com/services/

XOBJEX::Zip2State

A web service that given a specified U.S. Zip Code, returns the city and U.S. State to which the Zip Code belongs. For example: http://xobjex.com/service/zip2state.xsl?zipcode=90292 will return latitude, longitude, city, state, and zipcode in an XML graph. The data is from the 2000 U.S. Census.

Contact dan@xobjex.com for support. See other REST Services at: http://xobjex.com/services/

XOBJEX::Registry

A syndicated registry of HTTP-callable software services returning XML. Use XOBJEX::Registrar to register services that you provide.

Contact dan@xobjex.com for support. See other REST Services at: http://xobjex.com/services/