Hvad er hvile?
mange offentligt tilgængelige tjenester udsætter en REST-API, der muliggør en bred vifte af applikationer fra userebbrugergrænseflader til back-end systemintegration og synkronisering. Så hvad der præcist er hvile og hvad der gør en API afslappende?,
RESTEN – Repræsentationelle State Transfer
Teknisk, RESTEN står for Repræsentative State Transfer (så det er ikke en perfekt forkortelse), og betyder dybest set, at det er en arkitektur, der er beregnet til at overføre en repræsentation af server data, eller tilstand mellem en klient og server.
Der er et par detaljerede kriterier, der anses for nødvendige for en API til at være God, men det vigtigste er, at API være:
- Statsløse
Dette betyder, at der ikke er nogen nødvendig session, der er afholdt mellem en klient og server., Data modtaget fra serveren kan bruges af klienten uafhængigt. Dette giver mulighed for korte, diskrete operationer, og endda offline caching af data. Dette gør hvile en naturlig pasform til HTTP-operationer, hvor anmodninger er beregnet til at være ental og kortvarig.
- Uniform
REST API ‘ er er beregnet til at være selvbeskrivende, ensartet i deres definition, og hver operation adskilt af et andet endepunkt eller URL. I praksis implementerer de fleste REST-API ‘ er klassiske CRUD (Opret, Læs, Opdater, Slet) operationer mod en datamodel., Denne ensartethed giver udviklere mulighed for nemt at lære brugsmønsteret for hver API.
så hvordan ser en REST API ud?
fordi det er meningen at være repræsentativt, lad os starte med den datamodel, som den er beregnet til at repræsentere. For eksempel, hvis vi har en online handelsapplikation, ønsker vi at definere operationerne til styring af produkter i vores katalog, centreret omkring produktmodellen.
hver af disse operationer vil være knyttet til en kombination af en URL og et HTTP-verb., At gennemgå, der er mange http verber, men de fleste developmentebudvikling bruger kun GET og POST verber til at anmode om en URL eller udstationering formulardata, henholdsvis. Men REST bruger flere HTTP-verb til at signalere til serveren, hvilken type operation klienten udfører.
følgende er en forenklet liste over Webadresser, kombineret med HTTP-verbum, som vi ville bruge til at afsløre den fulde API for håndtering af et produktkatalog:
operationer og Webadresserne ovenfor er blot de grundlæggende operationer på en enkelt model., REST API ‘ er kan også understøtte meget specifikke operationer eller hierarkiske operationer. For eksempel, hvis du ønsker at sende et signal til serveren for at genbestille en levering af produkter, du kan udsætte en URL som denne:
/produkter/{id}/rediger | POST | Signal til den server, som du ønsker at genbestille mængder af et produkt {id}. Meddelelseskroppen kan være tom eller indeholde en datamodel, der bruges til detaljerede instruktioner om genbestillingsoperationen., |
Eller, hvis du ønsker at dykke ned i produkt kataloget og køre en forespørgsel, der returnerer en liste af alle ordrer, der for et givet produkt, API kan udsætte en operation som denne:
/produkter/{id}/ordrer | HENT | Givet en {id} for et produkt, returnere alle ordrer., |
og Omvendt, du kan udsætte en for-centreret slutpunkt, der giver dig mulighed for at vise alle produkter i den rækkefølge:
/ordrer/{id}/produkter | HENT | Givet en ordre, {id} tilbagevenden af alle produkter i den rækkefølge. |
Hvordan ser serverdataene ud?,
selvom der ikke er noget strengt krav til, hvilken type data en REST-API bruger eller returnerer, er det blevet en de facto-standard for RESTEBBASEREDE REST-API ‘ er at bruge JSON som datadefinition.dette skyldes, at JSON er et oprindeligt format, som alle moderne bro .sere kan bruge til at repræsentere hierarkiske objekter. For mere information om JSON, læs vores artikel Hvad er JSON?
Hvis du vil vide mere om vores produkter, skal du kontakte din OAS salgsrepræsentant gratis i USA på 1-800-533-4994 eller for internationale forespørgsler ringe 1-303-679-0898.