Difference between revisions of "Web Services"

From Creative Commons
Jump to: navigation, search
(Undo revision 81886 by Jaxaza (talk))
 
(16 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 
[[Category:Developer]]
 
[[Category:Developer]]
[[Category:Developer:WebServices]]
+
[[Category:Integration]]
 
[[Category:Technology]]
 
[[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]].
 
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]].
  
Line 12: 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 from the [http://cctools.sourceforge.net ccTools SourceForge Project].  Server source is maintained in the [http://cvs.sourceforge.net/viewcvs.py/cctools/api/ api module].  Sample client implementations are maintained in the [http://cvs.sourceforge.net/viewcvs.py/cctools/api_client/ api_client module].
+
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 '''api''' module in CVS. 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.
+
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 24: 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.
  
== Related Pages ==
+
{{Challenge Enabled}}
 
 
* [[Web Services Client Implementations]]
 

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 }}