REST API
REST API
REST API는 주문(Order)이나 사용자(User)와 같은 리소스를 중심으로 구축된 HTTP 인터페이스입니다. 각 요청은 독립적이며, 표준 HTTP 의미를 사용하고, 캐싱을 지원할 수 있으며, 여러 계층을 통과할 수 있습니다.
다른 예시
창고 애플리케이션은 `/orders/784`를 가져와 조건부 `PATCH`로 주소를 변경하고 `Link` 헤더를 따라 추적합니다. 상태를 가지지 않은 서버라면 어떤 서버도 요청을 처리할 수 있습니다. `ETag`가 오래된 경우 서버는 새로운 편집을 교체하는 대신 412를 반환합니다.
주요 부분
- 01리소스 식별자
- 02통일된 HTTP 작업
- 03표현 및 링크
사용할 때
리소스 기반 HTTP, 캐싱, 미들레이어, 그리고 자체적으로 변경 가능한 클라이언트가 제품에 적합할 때 REST를 사용하십시오.
다음 경우에는 사용하지 마세요
API가 HTTP를 통해 JSON을 전송한다고 해서 RESTful인 것은 아니다. 상태를 가진 세션, RPC 명령 터널, 또는 HTTP 의미를 무시하는 것은 다른 설계 방식이다.
코드에서 사용된 이름
client-server + stateless + cache + uniform interface + layered system + hypermedia 출시하기 전에
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 REST API (REST API)。 User context:창고 애플리케이션은 `/orders/784`를 가져와 조건부 `PATCH`로 주소를 변경하고 `Link` 헤더를 따라 추적합니다. 상태를 가지지 않은 서버라면 어떤 서버도 요청을 처리할 수 있습니다. `ETag`가 오래된 경우 서버는 새로운 편집을 교체하는 대신 412를 반환합니다. Technical concept or control:REST API (REST API)。 Why it fits:리소스 기반 HTTP, 캐싱, 미들레이어, 그리고 자체적으로 변경 가능한 클라이언트가 제품에 적합할 때 REST를 사용하십시오. Do not use it when:API가 HTTP를 통해 JSON을 전송한다고 해서 RESTful인 것은 아니다. 상태를 가진 세션, RPC 명령 터널, 또는 HTTP 의미를 무시하는 것은 다른 설계 방식이다. 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):하나의 공식 표준이 전체 용어를 통제하지 않음. 의미는 팀, 플랫폼 또는 프레임워크마다 달라질 수 있음. 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.
이 요청을 확인하세요
Review how REST API (REST API) is used now. Definition: REST API는 주문(Order)이나 사용자(User)와 같은 리소스를 중심으로 구축된 HTTP 인터페이스입니다. 각 요청은 독립적이며, 표준 HTTP 의미를 사용하고, 캐싱을 지원할 수 있으며, 여러 계층을 통과할 수 있습니다. 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.