Referencer

Nedenfor kan du finde referencer til relevant litteratur, standarder og værktøjer.

REST generelt

Den korte introduktion

Stefan Tilkov har skrevet en kort, dækkende introduktion til REST: A Brief Introduction to REST

Definitionen

Roy Fielding introducerede og beskrev REST i sin PHD afhandling:
Fielding, Roy Thomas, Architectural Styles and the Design of Network-Based Software Architectures, University of California, Irvine, 2000

Grundbogen

Leonard Richardson og Sam Ruby har skrevet en god og dækkende beskrivelse af, hvorledes REST baserede web services designes, udvikles og anvendes:
Richardson, Leonard and Sam Ruby, RESTful Web Services, O’REILLY, 2007

Kogebogen

Subbu Allamaraju beskriver i en række konkrete opskrifter, hvorledes Restful web services designes:
RESTful Web Services Cookbook, O’REILLY, 2010.

Checklisten

Steve Vinoski har skrevet en kort og god checkliste til design og udvikling af REST baserede web services:
Steve Vinoski, RESTful Web Services Development Checklist, IEEE Internet Computing, November/December 2008

Gartners REST anbefaling

Mange organisationer bruger Gartners anbafalinger i deres it-strategiarbejde. Gartner anbefaler brugen af REST i følgende artikel:

Nicholas Gall, Daniel Sholler & Anthony Bradley: Tutorial: Web-Oriented Architecture: Putting the Web Back in Web Services, 11 November 2008, Gartner

OIOREST referencer

Offentlig fællesviden i Det Digitale Danmark

Offentlig fællesviden i Det Digitale Danmark er et dokument, der er henvendt til offentlige myndigheder og har til formål at belyse behovet for REST-baserede dataservices i Det Digitale Danmark samt præsentere nogle muligheder og barrierer for Det Digitale Danmarks anvendelse af disse services. Dokumentet, der ikke forudsætter den store tekniske indsigt, giver en indsigt i hvad REST kan anvendes til, og kan bruges som inspirationskilde til de myndigheder, som ligger inde med data, som ønskes gjort offentlig tilgængelige:
Offentlig fællesviden i Det Digitale Danmark

Sikkerhedsmodeller for OIOREST

Publikationen henvender sig til offentlige myndigheder samt private virksomheder, der ønsker at udstille sikkerhedsbelagte data eller services baseret på OIOREST. Guiden beskriver sikkerhedsmodeller, der kan anvendes i forbindelse med OIOREST. Formålet er at opnå fundamentale sikkerhedsmæssige egenskaber for kommunikationen herunder autenticitet, integritet og konfidentialitet. Anvendelse af de beskrevne sikkerhedsmodeller gør det muligt at udbyde eller anvende web services, der eksponerer følsomme data eller udbyder kritiske ressourcer via internettet.

Sikkerhedsmodellerne tager udgangspunkt to alment forekommende scenarier for serviceintegration: det første scenarie består af et system-til-system kald via internettet, og det andet scenarie udvider det første med kald på vegne af en bruger.

Publikationen indeholder også en juridiske del, der er udarbejdet for at give et kortfattet overblik over de krav især personoplysningsloven stiller. Vejledningen vil derfor ikke gå i detaljer med de enkelte forhold, i stedet gives et overblik, som hjælper godt fra start i forbindelse med brug af OIOREST.
Sikkerhedsmodeller for OIOREST

OIOREST i praksis

Publikationen er rettet mod udviklere, der skal implementere REST baserede web services. Både de services, som er rettet mod offentlige data og de services som er rettet mod sikkerhedsbelagte data. Publikationen tager udgangspunkt i to kørende demoservices: Danmark servicen og Køservicen. Danmark servicen giver et eksempel på hvorledes offentlige data kan udstilles. Det er med udgangspunkt i Køservicen at de sikkerhedsmæssige aspekter omkring OIOREST services behandles.
OIOREST i praksis

Demoservice: Danmark servicen

Formålet med Danmark servicen er at være inspirations- og motivationskilde for udstilling af andre offentlige data. Danmark webservicen er et eksempel på hvorledes et design af en REST baseret webserviec kan være, hvorledes en REST baseret web service kan dokumenteres, hvilke repræsentationer der kan anvendes, samt vise at kodeeksempler vil lette udviklingen af programmer, der skal anvende webservicen. Der er endvidere udviklet to klienter til danmarkservicen: En rig samt en browserbaseret klientapplikation

Demoservice: Køservicen

Der er udviklet en kørende demoservice, som eksemplificerer sikkerheden i OIOREST. Servicen er beskrevet vha. noget generel information, beskrivelse af web api’et, eksempler på anvendelser af web api’et, eksempler på kode der anvender api’et i Java og C# samt køservicens kildetekst. Til illustration af de to sikkerhedsmodeller er der endvidere udviklet to klienttyper: En rig klient samt en web applikation klient. Begge er kort beskrevet nedenfor.

Mønster: Offentlige data

Offentlige data er et mønster,  som beskriver hvorledes offentlige data kan udstilles. Mønsteret er en del af Implementeringsmodel for forretningsservice.

Mønster: Mine data

Mine data er et mønster, som beskriver hvorledes sikkerhedsbelagte data kan udstilles. Mønsteret er en del af Implementeringsmodellen for forretningsservice.

Standarder, arkitektur og principper

HTTP

HTTP standarder (RFC 2616)

URI

URI standarder (RFC 3986)

Postel lov eller Robusthedprincippet

Be conservative in what you do; be liberal in what you accept from others.

Værktøjer

Curl

Curl er et kommandolinjeværktøj, som du kan bruge til at kommunikere med REST baserede web services. Cur kan downloades her.