/>API design

See how endpoints, status codes, pagination, and idempotency form a contract. — 26 entries

···

Token bucket rate limiting토큰 버킷 속도 제한

Requests spend replenishing tokens, controlling average API rate while permitting short bursts.

···

REST Resource ModelREST 자원 모델

URIs identify resources while HTTP methods express reading, creating, and changing them.

···

Cursor Pagination커서 페이지네이션

A cursor resumes after the last seen item even when new items arrive ahead of it.

···

Offset Pagination오프셋 페이지네이션

Offset and limit select a position, but inserts ahead of it can shift page boundaries.

···

Idempotency Key멱등성 키

A repeated request key prevents a retried creation from running the operation twice.

···

API Error EnvelopeAPI 오류 응답 형식

A consistent code, message, and details shape simplifies client handling across failures.

···

API ContractAPI 계약

Paths, requests, responses, and failures form a shared promise between client and server.

···

Schema Validation스키마 검증

Validate input types, required fields, and ranges against a schema at the API boundary.

···

GraphQL QueryGraphQL 질의

Clients select the fields they need, and responses follow that selection.

···

GraphQL N+1 ProblemGraphQL N+1 문제

Resolving a related field separately for every row multiplies database calls.

···

gRPC StreaminggRPC 스트리밍

One RPC can send or receive a sequence of messages instead of one pair.

···

Webhook Delivery웹훅 전달

A provider sends an event to a receiver URL and retries when delivery fails.

···

API GatewayAPI 게이트웨이

One entry point applies authentication, rate limits, and service routing.

···

OpenAPI 3.2

The specification describes HTTP QUERY, additional operations, and streaming representations.

···

OpenAPI Streaming Media TypesOpenAPI 스트리밍 미디어 표현

OpenAPI 3.2 describes responses whose items arrive sequentially, including JSON Lines and SSE.

···

Arazzo API WorkflowsArazzo API 워크플로

Describe a user journey as API steps with outputs feeding later inputs.

···

OpenAPI OverlaysOpenAPI 오버레이

Apply a separate set of actions to enrich an API description without editing the source.

···

GraphQL OneOf InputGraphQL OneOf 입력

A @oneOf input object accepts exactly one provided, non-null choice.

···

OpenAPI Additional OperationsOpenAPI 추가 HTTP 연산

OpenAPI 3.2 additionalOperations describes HTTP methods outside the fixed method fields.

···

API Backward CompatibilityAPI 하위 호환성

Check whether a new server contract still satisfies existing client expectations.

···

OpenAPI Nested TagsOpenAPI 중첩 태그

OpenAPI 3.2 parent and kind organize operation tags into a documentation hierarchy.

···

GraphQL over HTTP DraftGraphQL over HTTP 초안

A draft defines interoperable HTTP methods and response media types for GraphQL.

···

AsyncAPI Steps in ArazzoArazzo의 AsyncAPI 단계

Arazzo 1.1 connects message send and receive steps, matching the reply by correlation ID.

···

OpenAPI Device Authorization FlowOpenAPI 기기 인가 흐름

OpenAPI 3.2 describes the OAuth flow and URLs used by input constrained devices.

···

API VersioningAPI 버저닝

Offer a changed contract as a new version while existing consumers keep working.

···

Content Negotiation콘텐츠 협상

The Accept header asks for a representation and the server selects a supported response type.

Open as page ↗