REST-API — ressourcer, endpoints, HTTP-verber (GET/POST/PUT/DELETE)

Kommunikation og IT A · HTX · A-niveau · Netværk og protokoller

💻 REST API

REST (Representational State Transfer) er en arkitekturstil til webtjenester. Et REST API eksponerer ressourcer via URL-endpoints.

REST-principper:

1. Stateless: serveren gemmer ingen klienttilstand

2. Ressource-baseret: alt er en ressource med unik URL

3. HTTP-verber: GET (læs), POST (opret), PUT (erstat), PATCH (opdater), DELETE (slet)

Eksempel — bruger-API:

```

GET /api/brugere → hent alle brugere

GET /api/brugere/42 → hent bruger 42

POST /api/brugere → opret ny bruger

PUT /api/brugere/42 → erstat bruger 42

PATCH /api/brugere/42 → opdater dele af bruger 42

DELETE /api/brugere/42 → slet bruger 42

```

Response-format: JSON er standarden.

```json

{"id": 42, "navn": "Alice", "email": "alice@mail.dk"}

```

Statuskoder: 200 OK, 201 Created, 400 Bad Request, 401 Unauthorized, 404 Not Found.

Flask REST-API eksempel:

```python

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api/brugere/<int:id>', methods=['GET'])

def get_bruger(id):

return jsonify({"id": id, "navn": "Alice"})

```

Læringsmål

• Designe et REST API med korrekte endpoints og HTTP-verber
• Implementere et simpelt REST API i Flask
• Forklare REST-principperne og stateless-kravet
• Teste et API med Postman eller curl

Sådan kan du arbejde med emnet

• Design endpoints (URL og HTTP-verb) til et API der kan oprette, hente, opdatere og slette en bruger
• Forklar forskellen på PUT og PATCH
• Beskriv hvad en statuskode som 201 Created betyder i et REST-API

Træningsforslag

• Byg et REST API til en todo-liste (GET, POST, PUT, DELETE)
• Test dit API med Postman og dokumentér alle endpoints
• Brug fetch() i JavaScript til at konsumere dit API fra en browser