Informacje o interfejsach API typu REST

REST to styl architektury oprogramowania zapewniający wygodne i spójne podejście do żądania i modyfikowania danych.

Termin REST to skrót od „Representational State Transfer”. W kontekście interfejsów API Google oznacza korzystanie z czasowników HTTP do pobierania i modyfikowania reprezentacji danych przechowywanych przez Google.

W systemie REST zasoby są przechowywane w magazynie danych. Klient wysyła żądanie, aby serwer wykonał określone działanie (takie jak utworzenie, pobranie, zaktualizowanie lub usunięcie zasobu), a serwer je wykonuje i wysyła odpowiedź, często w formie reprezentacji określonego zasobu.

W interfejsach API Google typu REST klient określa działanie za pomocą czasownika HTTP, takiego jak POST, GET, PUT czy DELETE. Zasób określa zasób za pomocą unikalnego globalnie identyfikatora URI o takiej postaci:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Wszystkie zasoby interfejsu API mają unikalne identyfikatory URI dostępne przez HTTP, dlatego REST umożliwia buforowanie danych i jest zoptymalizowany pod kątem współpracy z rozproszoną infrastrukturą sieci.

Definicje metod można znaleźć w dokumentacji standardów HTTP 1.1. Zawierają one specyfikacje GET, POST, PUT i DELETE.