REST API
API REST
Un'API REST è un'interfaccia HTTP costruita attorno a risorse, come ordini o utenti. Ogni richiesta è autonoma, utilizza i significati standard di HTTP, può supportare la memorizzazione nella cache e può passare attraverso più livelli.
Un altro esempio
Un'applicazione di magazzino ottiene `/orders/784`, cambia il suo indirizzo con un `PATCH` condizionale, e segue un'intestazione `Link` per il tracciamento. Qualsiasi server senza stato può gestire la richiesta. Se l'`ETag` è vecchio, il server restituisce 412 invece di sostituire una modifica più recente.
Parti principali
- 01Identificatore della risorsa
- 02Operazione HTTP uniforme
- 03Rappresentazione e link
Usalo quando
Usa REST quando HTTP basato su risorse, caching, strati intermedi e client che possono cambiare autonomamente si adattano al prodotto.
Non usarlo quando
Un'API non è RESTful solo perché invia JSON tramite HTTP. Sessioni con stato, tunnel di comandi RPC o significati HTTP ignorati sono design diversi.
Nome usato nel codice
client-server + stateless + cache + uniform interface + layered system + hypermedia Prima di spedire
Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.
Outcome: Complete the task with API REST (REST API). User context: Un'applicazione di magazzino ottiene `/orders/784`, cambia il suo indirizzo con un `PATCH` condizionale, e segue un'intestazione `Link` per il tracciamento. Qualsiasi server senza stato può gestire la richiesta. Se l'`ETag` è vecchio, il server restituisce 412 invece di sostituire una modifica più recente. Technical concept or control: API REST (REST API). Why it fits: Usa REST quando HTTP basato su risorse, caching, strati intermedi e client che possono cambiare autonomamente si adattano al prodotto. Do not use it when: Un'API non è RESTful solo perché invia JSON tramite HTTP. Sessioni con stato, tunnel di comandi RPC o significati HTTP ignorati sono design diversi. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary): Nessun singolo standard ufficiale controlla l'intero termine. Il suo significato può cambiare tra team, piattaforme o framework. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.
Controlla questa richiesta
Review how API REST (REST API) is used now. Definition: Un'API REST è un'interfaccia HTTP costruita attorno a risorse, come ordini o utenti. Ogni richiesta è autonoma, utilizza i significati standard di HTTP, può supportare la memorizzazione nella cache e può passare attraverso più livelli. Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.