Our current web service for issuing a license, /license/<class>/issue (where <class> describes the license class; ie, standard), requires that the client construct a chunk of XML and perform an HTTP POST. After some thought, this seems a bit heavy, and as Mike pointed out, not exactly RESTful (nothing is being changed on the server, so a GET is more appropriate).
So I've just enabled a new feature in the dev API, /license/<class>/get. The get method, as its name implies, is meant to be used with an HTTP GET request, and all the parameters for issuing the license can be specified on the query string. For example: http://api.creativecommons.org/rest/dev/license/standard/get?locale=en&commercial=n&derivatives=n&jurisdiction= will return the information for Attribution-NonCommercial-NoDerivs 2.5 (in English). See http://api.creativecommons.org/docs/readme_dev.html#license-class-get for documentation. Any feedback would be appreciated and welcome. If I don't hear any objections, we'll start using this call in ccPublisher and back port it to the 1.5 stable API. Nathan R. Yergler Software Engineer Creative Commons _______________________________________________ cc-devel mailing list [email protected] http://lists.ibiblio.org/mailman/listinfo/cc-devel
