Every article tagged REST API, in one place.
Showing 8 articles
FastAPI is a Python web framework built on type hints. You describe your inputs and outputs with types, and FastAPI validates requests, serialises responses and generates interactive API docs for you. Install and run pip install "fastapi[standard]" fastapi dev...
A well-designed REST API is predictable: once a developer has used one endpoint, they can guess how the others work. These conventions get you most of the way there. URLs name resources, not actions GET /orders list orders POST /orders create an order GET /ord...
Any list endpoint needs pagination. The two main approaches behave very differently on large or fast-changing data. Offset pagination GET /articles?page=3&per_page=20 SELECT * FROM articles ORDER BY published_at DESC LIMIT 20 OFFSET 40; Pros: simple, lets user...
Once other people depend on your API, every change can break someone. Versioning gives you room to evolve without surprises. First: avoid breaking changes Usually safe (additive): Adding a new endpoint. Adding an optional request field. Adding a field to a res...
Go developers used to reach for a router package as soon as they needed path parameters. Since Go 1.22, the standard http.ServeMux supports HTTP methods and wildcards, which covers most APIs. The server package main import ( "encoding/json" "log" "net/http" "s...
Every API needs an error format, and many invent their own. Problem Details (RFC 9457, which replaced RFC 7807) is a standard JSON shape for HTTP API errors that clients and tools already understand. The format HTTP/1.1 403 Forbidden Content-Type: application/...
GraphQL and REST both work well. The right choice depends on your clients, your data and your team, not on which one is newer. The core difference With REST, the server decides the shape of each endpoint's response. With GraphQL, the client asks for exactly th...
Axum is a popular Rust web framework from the Tokio team. Handlers are plain async functions, and "extractors" in their parameters pull data out of the request in a type-safe way. Dependencies [dependencies] axum = "0.8" tokio = { version = "1", features = ["f...
