Набір проєктування API
Посібник зі стилю API, специфікації REST (OpenAPI 3.2), подій, GraphQL і gRPC, політика версій і застарівання, довідкова документація для розробників.
Стандарти
API Design Guidelines Template (Company Style Guide)
ПовнийCompany API style guide: naming, methods, status codes, RFC 9457 errors, pagination, versioning, security, webhooks, governance
API Versioning and Deprecation Policy Template
СтандартAPI lifecycle policy: versioning scheme, compatibility promises, breaking changes, timelines, Deprecation and Sunset headers
RFC 9745 (Deprecation header), RFC 8594 (Sunset header)
Специфікації
REST API Specification Template (OpenAPI 3.2, RFC 9457)
ПовнийHTTP/JSON API contract: auth, conventions, QUERY, streaming, pagination, RFC 9457 errors, endpoints, webhooks, OpenAPI 3.2 skeleton
OpenAPI 3.1, RFC 9110, RFC 9457Event-Driven API Specification Template (AsyncAPI 3)
ПовнийAsync event contract: brokers, channels, operations, CloudEvents envelope, ordering, delivery, DLQ, schema evolution, AsyncAPI YAML
AsyncAPI 3.0, CloudEvents 1.0GraphQL Schema Specification Template
ПовнийGraphQL API spec: types, queries, mutations, subscriptions, connections, nullability, errors, auth, cost limits, federation
GraphQL specification (September 2025 edition)gRPC Service Specification Template (Protocol Buffers)
СтандартgRPC service spec: .proto contract, package versioning, field compatibility, google.rpc errors, deadlines, retries, streaming
gRPC and Protocol Buffers documentationInterface Control Document (ICD) Template
ПовнийICD between two systems – parties, requirements allocation, data element table, protocol sequence, errors, security, timing, change control
Документування
REST Endpoint Reference Template
СтандартOne REST endpoint: auth, parameter tables, request example, responses per status, RFC 9457 errors, limits, idempotency, paging
OpenAPI, RFC 9457API Overview and Getting Started Template
СтандартAPI landing page – what it does, base URLs, auth in 3 steps, first request, key resources, errors, limits, next steps
Developer and SDK Guide Template
ПовнийDeveloper guide – setup, auth, multi-language quick start, errors, pagination, rate limits, webhooks, sandbox, versioning