Difference between revisions of "Web Services"
CC Wiki Bot (talk | contribs) |
|||
(20 intermediate revisions by 10 users not shown) | |||
Line 1: | Line 1: | ||
[[Category:Developer]] | [[Category:Developer]] | ||
− | [[Category: | + | [[Category:Integration]] |
− | Creative Commons provides a set of web services which allow application developers to integrate license selection with their own software. The web services are designed to be a more flexible replacement for the HTML-only [ | + | [[Category:Technology]] |
+ | |||
+ | Creative Commons provides a set of web services which allow application developers to integrate license selection with their own software. The web services are designed to be a more flexible replacement for the HTML-only [[Web Integration Guide|partner interface]]. | ||
== Background == | == Background == | ||
Line 11: | Line 13: | ||
* an interface to generate the license URL, along with description RDF for a given license and set of answers | * an interface to generate the license URL, along with description RDF for a given license and set of answers | ||
− | Sourcecode for the web services is available | + | Sourcecode for the web services is available at [http://code.creativecommons.org code.creativecommons.org]. Server source is maintained in the [http://code.creativecommons.org/viewsvn/api/ api module]. Sample client implementations are maintained in the [http://code.creativecommons.org/viewsvn/api_client api_client module]. |
− | The web services use an XML representations of the licenses and their questions. The XML files and XSLT transformations used for this process are also stored in the ''' | + | The web services use an XML representations of the licenses and their questions. The XML files and XSLT transformations used for this process are also stored in the '''license_xsl''' module in Subversion. ChooseLicense.xml represents the available Creative Commons licenses, along with the "questions" which need to be answered to select a particular license, in an XML format. Combined with an XSLT file, this allows us to easily plug the license engine into different environments. |
== Documentation == | == Documentation == | ||
Line 23: | Line 25: | ||
The development REST interface is rooted at http://api.creativecommons.org/rest/dev. Documentation and a summary of changes since the last stable version is available at http://api.creativecommons.org/readme_dev.html. | The development REST interface is rooted at http://api.creativecommons.org/rest/dev. Documentation and a summary of changes since the last stable version is available at http://api.creativecommons.org/readme_dev.html. | ||
− | + | {{Challenge Enabled}} | |
− | |||
− | |||
− |
Latest revision as of 03:28, 19 April 2014
Creative Commons provides a set of web services which allow application developers to integrate license selection with their own software. The web services are designed to be a more flexible replacement for the HTML-only partner interface.
Background
Creative Commons provides a REST web service interfaces. Through the CC web service API, you can generate any of the Creative Commons licenses, including Sampling. The web services API 1.5 is frozen and can be considered stable. A development API is also supported, where new features are prototyped. The development API should not be considered stable. The API presents the following layers of abstraction:
- a selection of license "classes" available (standard, public domain, GPL, etc)
- a set of questions (along with possible responses, if applicable) that must be answered in order to issue a license
- an interface to generate the license URL, along with description RDF for a given license and set of answers
Sourcecode for the web services is available at code.creativecommons.org. Server source is maintained in the api module. Sample client implementations are maintained in the api_client module.
The web services use an XML representations of the licenses and their questions. The XML files and XSLT transformations used for this process are also stored in the license_xsl module in Subversion. ChooseLicense.xml represents the available Creative Commons licenses, along with the "questions" which need to be answered to select a particular license, in an XML format. Combined with an XSLT file, this allows us to easily plug the license engine into different environments.
Documentation
Two versions of the REST web service are currently maintained, the 1.5 version and development version. The 1.5 version is a stable API and is only updated with new jurisdictions as they become available. The Development version is where new features are implemented and API changes may occur; at some point this will be branched again and versioned. See the Web Services Plan page for future web service ideas and version details.
The stable REST interface is rooted at http://api.creativecommons.org/rest/1.5. Documentation of methods available is available at http://api.creativecommons.org/readme_15.html.
The development REST interface is rooted at http://api.creativecommons.org/rest/dev. Documentation and a summary of changes since the last stable version is available at http://api.creativecommons.org/readme_dev.html.
Web Services | |
---|---|
Have an idea about this page? Want to help build the CC ecosystem? Check out the challenges related to Web Services, or add one of your own below. | |
Open Challenges | |
{{#ask: Is Complete::no
Related To::Web Services|format=table}} |
|
Completed Challenges | |
{{#ask: Is Complete::yes
Related To::Web Services|format=table}} |
|
{{#forminput:Challenge|35 | Challenge[related_to]=Web Services }} |