Products API

From Mandriva Community Wiki

This page is a draft. It requires improvements.
If you want to contribute, simply click on the edit tab. View the other pages to improve and maintain.

Relies on Mandriva Release Spec to identify objects (distribution, release, and so on).

MUST describe:

• all Mandriva distributions that are shipped (including Community and specific distributions for customers) and supported.
• each product lifetime,
• distribution (2010.0), release (2010.0 Official for x86_64), product (Powerpack 2010.0 Official for x86_64).
• medias,
• attached services to products

Returned document formats

UTF-8 encoded XML documents.

Depending on the object, the schema will be different.

Error document

List document (list of objects found)

Release document

Public methods

get information on an arbitrary object

HTTP GET on http://api/id?id=[identifier]

Will return a XML-formatted string, depending on the object type (see above).

get all distributions

HTTP GET on http://api/distribution?

get distribution (id)

HTTP GET on http://api/id?distribution=Mandriva%40Linux

get all versions

HTTP GET on http://api/id?version

get version

HTTP GET on http://api/id?version=2006.0

get all releases (after /etc/release)

HTTP GET on http://api/id?etc_release HTTP GET on http://api/id?etc_release=Mandriva%20Linux%20release%202006.1%20(Official)%20for%20i586

get all products

HTTP GET on http://api/id?product

get product (type)

HTTP GET on http://api/id?product=PowerPack

Complex queries

You may make complex queries, when they make sense.

HTTP GET on http://api/id?distribution=2006.0&tag=Official&arch=x86_64&product=PowerPack

will return a XML document listing all matching objects (can be 0, 1 or many), with their respective ids.

To get the detail about an object, you will have to use the http://api/id?id=... query.