A REST API for Content Management

download A REST API for Content Management

of 120

  • date post

    01-Sep-2014
  • Category

    Technology

  • view

    4.148
  • download

    1

Embed Size (px)

description

Baking semantic web access into non-geek services

Transcript of A REST API for Content Management

  • A REST API for Content Management baking semantic web access into non-geek services
  • Stephen Howard Athens, Georgia [email_address] http://enterity.com
  • a presentation in 3 acts
  • a presentation in 3 acts what is renao?
  • a presentation in 3 acts what is renao? the renao API
  • a presentation in 3 acts what is renao? the renao API building a community
  • act 1 what is renao?
  • renao [ren- ah -oh], adj. what is renao? From Mandarin. Lierally " hot " but also includes "noisy," "making noise," and "stirring up trouble. In China the term is a positive, implying " lively, festive, happy, noisy " - especially noisy! from In Other Words by Christopher J. Moore http://myrenao.com/what
  • renao [ren- ah -oh], n. A hosted content management service http://myrenao.com
  • content management what is renao?
  • content management what is renao?
  • design management what is renao?
  • design management what is renao?
  • flexible results what is renao?
  • three guiding principles what is renao?
  • three guiding principles what is renao? content has structure
  • three guiding principles what is renao? content has structure URLs are nouns
  • three guiding principles what is renao? content has structure URLs are nouns templates for many formats
  • 1: content has structure what is renao: 3 guiding principles
  • 1: content has structure what is renao: 3 guiding principles most organizations have collections of things (resources), physical or conceptual, that they want to publish online
  • 1: content has structure what is renao: 3 guiding principles most organizations have collections of things (resources), physical or conceptual, that they want to publish online these resources usually have a consistent set of structured or semi-structured information
  • 1: content has structure what is renao: 3 guiding principles most organizations have collections of things (resources), physical or conceptual, that they want to publish online these resources usually have a consistent set of structured or semi-structured information let them use these structures theyre already familiar with when adding content to their sites
  • 1: content has structure what is renao: 3 guiding principles most organizations have collections of things (resources), physical or conceptual, that they want to publish online these resources usually have a consistent set of structured or semi-structured information let them use these structures theyre already familiar with when adding content to their sites a better format for machines to understand than flat html pages.
  • 2: URL s are nouns what is renao: 3 guiding principles
  • 2: URL s are nouns what is renao: 3 guiding principles URL s can refer to a specific resource http://example.com/about_us http://example.com/blog/designing_an_api
  • 2: URL s are nouns what is renao: 3 guiding principles or a list of resources URL s can refer to a specific resource http://example.com/Articles http://example.com/about_us http://example.com/blog/designing_an_api
  • 2: URL s are nouns what is renao: 3 guiding principles use query parameters to refine your results or a list of resources URL s can refer to a specific resource /Articles?name[like]=perl&sort=publish_date,desc http://example.com/Articles http://example.com/about_us http://example.com/blog/designing_an_api
  • 2: URL s are nouns what is renao: 3 guiding principles or use the full-text search parameter instead http://example.com?q=perl http://example.com/blog?q=perl use query parameters to refine your results or a list of resources URL s can refer to a specific resource /Articles?name[like]=perl&sort=publish_date,desc http://example.com/Articles http://example.com/about_us http://example.com/blog/designing_an_api
  • 2: URL s are nouns what is renao: 3 guiding principles or use the full-text search parameter instead http://example.com?q=perl http://example.com/blog?q=perl special shortcut URL s for tags use query parameters to refine your results or a list of resources URL s can refer to a specific resource http://example.com/Articles/t/perl http://example.com/blog/t/perl /Articles?name[like]=perl&sort=publish_date,desc http://example.com/Articles http://example.com/about_us http://example.com/blog/designing_an_api
  • 3: templates for many formats what is renao: 3 guiding principles how renao picks from your templates for a given request:
  • 3: templates for many formats what is renao: 3 guiding principles how renao picks from your templates for a given request: /article.html what kind of resource is it?
  • 3: templates for many formats what is renao: 3 guiding principles how renao picks from your templates for a given request: /resource.html cant find a template for that resource type? look for a template for the parent resource type. /article.html what kind of resource is it?
  • 3: templates for many formats what is renao: 3 guiding principles how renao picks from your templates for a given request: /articles.html is the request for a list of resources? /resource.html cant find a template for that resource type? look for a template for the parent resource type. /article.html what kind of resource is it?
  • 3: templates for many formats what is renao: 3 guiding principles how renao picks from your templates for a given request: check for template / blog/article.html otherwise use /article.html what collection is the resource in? /articles.html is the request for a list of resources? /resource.html cant find a template for that resource type? look for a template for the parent resource type. /article.html what kind of resource is it?
  • 3: templates for many formats what is renao: 3 guiding principles how renao picks from your templates for a given request: ends in .xml? -> use /article.xml is there a specific extension on the url? check for template / blog/article.html otherwise use /article.html what collection is the resource in? /articles.html is the request for a list of resources? /resource.html cant find a template for that resource type? look for a template for the parent resource type. /article.html what kind of resource is it?
  • a presentation in 3 acts what is renao? the renao API building a community
  • act 2 the renao API
  • API objectives the renao API
  • API objectives the renao API access your own site
  • API objectives the renao API access your own site write software for others to use
  • API objectives the renao API access your own site write software for others to use your site is your API, no special urls
  • API objectives the renao API access your own site write software for others to use your site is your API, no special urls manage content and design
  • API objectives the renao API access your own site write software for others to use your site is your API, no special urls manage content and design single authentication scheme
  • 1: access your own site the renao API: objectives
  • 1: access your own site the renao API: objectives update your site to reflect activities around the web
  • 1: access your own site the