The Catalog API is a set of MashupHub Atom Publishing Protocol (APP) feeds.
The MashupHub collections represented by those feeds are defined by an APP service document located at http://yourURL/mashuphub/atom
, where yourURL
is the base URL of the MashupHub installation. You can also use OpenSearch as a starting point because entries returned can be used in APP operations.
Accessing the service document using HTTP results in all URLs in the document using HTTP as the protocol. Accessing the document using HTTPS results in HTTPS URLs in the service document. A client can use either protocol, but all access through insecure HTTP is granted anonymous user permissions only. For full access, a client must use basic authentication via HTTPS.
Plug-ins identify the collections to which their content belongs. By default, the collection name corresponds to the OpenSearch query role for the collection. Multiple plug-ins can belong to a single collection.
APP fetch: imc3
APP create: imc3
For APP create (HTTP Post to the collection URL) operations, the default behavior of a plug-in is to register the URL of an existing feed hosted at an external location. A plug-in should override this default behavior by specifying a CollectionPlugin subclass.
APP edit: imc3
For APP edit (HTTP Put to the entry's "edit" URL) operations, the default behavior of a plug-in is to allow changes to the basic MashupHub metadata defined for entries in the feed collection.