Springnote

439001 Springnote 438997 2008-10-29T09:49:36Z http://dev.springnote.com/pages/439001 2007-08-28T02:26:50Z Welcome to Springnote's REST API page.   <div>If you have any questions while using or reading our API, please utilize our <a href="http://ecus-en.springnote.com/issues?tag=en_idea&tag=en_bugreport%20" class="external" title="http://ecus-en.springnote.com/issues?tag=en_idea&tag=en_bugreport ">Suggestions/Bug Reports</a> forum to contact us.</div>   <h3>Preparation</h3> In order to use the Springnote API, you need to understand the following items:   <ul> <li><a href="http://en.wikipedia.org/wiki/HTTP" class="external" title="http://en.wikipedia.org/wiki/HTTP">HTTP(S) Protocol</a></li> <li><a href="http://en.wikipedia.org/wiki/REST" class="external" title="http://en.wikipedia.org/wiki/REST">REST Style</a></li> <li><a href="http://oauth.net/" class="external" title="http://oauth.net/">OAuth Authentication</a></li> </ul>   These are all de facto standards which are widely used.   <h3>Request</h3> API request requires the following:   <ul> <li>Authentication information</li> <li>Resource URL</li> <li>Content type</li> <li>HTTP method and paramaters</li> </ul>   <h3>Authentication</h3> Although OAuth and basic HTTP authentication is provided together, we recommend that you utilize OAuth. For more detailed information, please refer to the <a href="http://oauth.net/" class="external" title="http://oauth.net/">OAuth page</a>.   To summarize, in order to access the notebook of a specified user, the user's Access Token is needed. After you have been issued the application from <Openmaru's API Center>, you can obtain tokens from the URLs listed below. This process is protected thus requiring an approval from the user.   <ul> <li>Request Token URL: <a href="https://api.openmaru.com/oauth/request_token">https://api.openmaru.com/oauth/request_token</a></li> <li>Authorize URL: <a href="https://api.openmaru.com/oauth/authorize">https://api.openmaru.com/oauth/authorize</a></li> <li>Access Token URL: <a href="https://api.openmaru.com/oauth/access_token/springnote">https://api.openmaru.com/oauth/access_token/springnote</a></li> </ul>   <h4>Resource URL</h4> All resources (Page, Attachment, etc.) provided by Springnote have its own URL. For example, in order to obtain information the page you are viewing now in XML, the following is requested: <img title="Untitled-1.jpg" class="attachment" src="/pages/334480/attachments/901328" alt="Untitled-1.jpg" /> <ol> <li>HTTP methods that can be used differs depending on the resource. For example, GET, POST, PUT, and DELETE are all supported for the page resource (/pages/#{id}). GET and POST are supported for page lists (/pages) while PUT and DELETE are not.</li> <li>HTTP and HTTPS are supported protocols which one is required to be selected and used.</li> <li>All API calls must be sent to the domain api.springnote.com.</li> <li>Each resource has its own URL.</li> <li>The extension is determined by the content type.</li> <li>The notebook domain can be defined by using a domain parameter. In a case where the domain is omitted, the first personal notebook of the user is seleceted by default.</li> </ol>   <h3>Content Type</h3> All Springnote resources are provided in XML and JSON types. You can also use the methods listed below to specify a desired content type. (This is strictly required. API calling is not approved if the methods listed below are not used)   <ul> <li>Add an appropriate extension. In other words, add an extension to the end of the URL. Example) .xml or .json.  (RECOMMENDED)</li> <li>The Content-Type Header request is filled by application/xml or application/json.</li> </ul>   The request and response type always correspond with each other. In other words, if you request through XML, the response will be given in XML.   <h3>Resource Parameters</h3> Listed below are possible ways to send resources using POST and PUT methods to Springnote. For example, to create a new page, you need to include the resource parameter in the API and then make a request.   <ul> <li> Resource is separated by attribute in the HTTP request parameter. The parameter value needs to be encoded, therefore the parameter name should be written as the resource (attribute) name. (RECOMMENDED) <ul> <li>Example) POST http://api.springnote.com/pages.xml?page[title]=NewPage&page[source]=test&page[relation_is_part_of]=1</li> </ul> </li> <li> XML or JSON is directed included into the HTTP request parameter. The parameter name is either xml or json. <ul> <li>Example) POST http://api.springnote.com/pages.xml?xml=<page><title>NewPage</title>...</page></li> </ul> </li> <li>Add the resource to the HTTP body. At the header of the HTTP request, Content-Type must be accurately determined. For example, for XML the Content-Type must be application/xml, while JSON must be application/json.</li> </ul>   <ol class="code"> <li>POST <a href="http://api.springnote.com/pages.xml">/pages.xml</a></li> <li>Host: api.springnote.com</li> <li>Header: application/xml</li> <li> </li> <li><page><title>NewPage</title>...</page></li> </ol>   <h3>Resource</h3> Resources provided in Springnote's API are as follows: <ul> <li> <a href="/pages/439059" class="wiki" title="pages resource">Page resources</a> <ul> <li><a href="/pages/439067" class="wiki" title="pages/*/attachments resource">Attachment resources</a></li> <li><a href="/pages/439071" class="wiki" title="pages/*/revisions resource">Revision resources</a></li> <li><a href="/pages/439076" class="wiki" title="pages/*/lock resource">Lock resources</a></li> <li><a href="/pages/439073" class="wiki" title="pages/*/collaboration resource">Collaboration resources</a></li> <li><a href="/pages/search?q=pages%2F*%2Fcomment%20resourcecomment%20resource&parent_id=439001" class="wiki" title="pages/*/comment resourcecomment resource">Comment resources</a></li> </ul> </li> </ul>   <h3>Response</h3> If the request is successful, resources in XML or JSON are provided along with 200 OK. If an error occurs, you will be provided with response status codes and an error message on your situation. <ul> <li><a href="/pages/439037" title="Response Status code" class="wiki">Response Status code</a></li> <li><a href="/pages/439053" title="Error message" class="wiki">Error message</a></li> </ul>   <h4>References</h4> <ul> <li><a href="/pages/439128" title="Library" class="wiki">Library</a></li> <li> <a href="http://ecus-en.springnote.com/issues" class="external" title="http://ecus-en.springnote.com/issues">Communities</a>   </li> </ul> deepblue deepblue 55