RESTpyynnöt

RESTpyynnöt ovat pyyntöjä, joita asiakkaat lähettävät REST-rajapintaan palvelun resurssien hallitsemiseksi sekä tiedon hakemiseen tai muokkaamiseen. Ne noudattavat REST-arkkitehtuuria, jossa resurssit identifioidaan Uniform Resource Identifier -URI:lla, ja toimintoja ohjataan HTTP-menetelmillä kuten GET, POST, PUT, PATCH ja DELETE. Yksittäinen pyyntö koostuu tyypillisesti URI:sta, HTTP-menetelmästä, otsikoista (esim. Accept, Content-Type, Authorization) sekä mahdollisesta viestibodysta, joka yleensä on JSON- tai XML-muodossa.

Kun pyyntö lähetetään, palvelin vastaa tilakoodilla ja mahdollisella viestillä. Yleisimmät tilakoodit ovat 200 OK, 201 Created, 204 No Content sekä virhekoodit kuten 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found ja 500 Internal Server Error. Viestien sisältöä hallitaan sisältöneuvottelulla käyttämällä Accept- ja Content-Type -otsikoita. Tyypillisesti REST-rajapintoja vastataan JSON- tai XML-esityksillä.

Ominaisuuksien hallinnassa tärkeää on tilan säilyttämisen vähentäminen: GET, HEAD ja OPTIONS ovat turvallisia; PUT ja DELETE ovat yleensä idempotenttejä; POST on usein ei-idempotentti. Turvallisuus ja käytettävyys vaativat asianmukaista todentamista (esim. API-avaimet, OAuth 2.0 tai JWT) sekä TLS-salausta.

Käytännössä RESTpyyntöjä rakennetaan monissa ympäristöissä: curl tai HTTP-asiakkaat ohjelmointikielissä, kuten Pythonin requests, JavaScriptin fetch, sekä testaus- ja kehitystyökalut kuten Postman. Hyvät käytännöt sisältävät selkeät URI-resurssit, oikeat HTTP-menetelmät ja johdonmukaisen virheenkäsittelyn.