{"id":"rfc-standards","title":"RFC Standards (IETF)","description":"Internet Engineering Task Force Request for Comments specifications that define core internet protocols and best practices for HTTP APIs.","standards":[{"id":"rfc-2119","name":"RFC 2119","title":"Key Words for Use in RFCs","description":"Defines the meaning of requirement levels: MUST, MUST NOT, SHOULD, SHOULD NOT, MAY, REQUIRED, RECOMMENDED, OPTIONAL. Used throughout the style guide to indicate compliance levels. Maps to Spectral severity: MUST/MUST NOT → error, SHOULD/SHOULD NOT → warn, MAY → info.","url":"https://datatracker.ietf.org/doc/html/rfc2119","usedFor":["Requirements language","Compliance levels","Spectral rule severity"]},{"id":"rfc-3986","name":"RFC 3986","title":"Uniform Resource Identifier (URI): Generic Syntax","description":"Defines the structure and syntax of URIs. Basis for URL path design rules (lowercase, no trailing slash, hierarchical structure). Covers scheme, authority, path, query, and fragment components.","url":"https://datatracker.ietf.org/doc/html/rfc3986","usedFor":["URL structure","Path design","Query parameters"]},{"id":"rfc-4122","name":"RFC 4122","title":"A Universally Unique Identifier (UUID) URN Namespace","description":"Defines the UUID format (128-bit identifier). Used for resource identifiers. Example: 550e8400-e29b-41d4-a716-446655440000. OpenAPI format: uuid.","url":"https://datatracker.ietf.org/doc/html/rfc4122","usedFor":["Resource identifiers","OpenAPI format: uuid"],"example":"550e8400-e29b-41d4-a716-446655440000"},{"id":"rfc-5322","name":"RFC 5322","title":"Internet Message Format","description":"Defines email address format. Referenced for email field validation. OpenAPI format: email.","url":"https://datatracker.ietf.org/doc/html/rfc5322","usedFor":["Email validation","OpenAPI format: email"]},{"id":"rfc-6570","name":"RFC 6570","title":"URI Template","description":"Defines URI template syntax for describing URI spaces. Used in OpenAPI path parameters: /users/{userId}. Supports path, query, and fragment expansion.","url":"https://datatracker.ietf.org/doc/html/rfc6570","usedFor":["Path parameters","URI templates"],"example":"/users/{userId}/orders/{orderId}"},{"id":"rfc-6648","name":"RFC 6648","title":"Deprecating the 'X-' Prefix in Application Protocols","description":"Recommends against using X- prefix for custom headers. Custom headers should use descriptive names without prefix. Example: Use Request-Id instead of X-Request-Id.","url":"https://datatracker.ietf.org/doc/html/rfc6648","usedFor":["Custom header naming"],"recommendation":"SHOULD NOT use X- prefix for new custom headers"},{"id":"rfc-6749","name":"RFC 6749","title":"The OAuth 2.0 Authorization Framework","description":"Defines OAuth 2.0 authentication/authorization flows. Recommended authentication mechanism for APIs. Covers authorization code, implicit, client credentials, and resource owner flows.","url":"https://datatracker.ietf.org/doc/html/rfc6749","usedFor":["API authentication","Authorization flows"]},{"id":"rfc-6750","name":"RFC 6750","title":"The OAuth 2.0 Authorization Framework: Bearer Token Usage","description":"Defines how to use bearer tokens in HTTP requests. Authorization header format: Authorization: Bearer {token}.","url":"https://datatracker.ietf.org/doc/html/rfc6750","usedFor":["Bearer token authentication"],"example":"Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."},{"id":"rfc-7396","name":"RFC 7396","title":"JSON Merge Patch","description":"Defines a simple format for partial JSON updates. Content-Type: application/merge-patch+json. Null values indicate field deletion. Recommended for PATCH operations.","url":"https://datatracker.ietf.org/doc/html/rfc7396","usedFor":["PATCH operations","Partial updates"],"contentType":"application/merge-patch+json"},{"id":"rfc-7807","name":"RFC 7807","title":"Problem Details for HTTP APIs","description":"Defines a standard format for error responses. Content-Type: application/problem+json. Fields: type (URI), title, status, detail, instance. Extensible with custom fields (e.g., errors array).","url":"https://datatracker.ietf.org/doc/html/rfc7807","usedFor":["Error responses","Problem details"],"contentType":"application/problem+json","fields":["type","title","status","detail","instance"]},{"id":"rfc-8288","name":"RFC 8288","title":"Web Linking","description":"Defines the Link header and link relations. Used for pagination (next, prev, first, last). Used for hypermedia navigation.","url":"https://datatracker.ietf.org/doc/html/rfc8288","usedFor":["Pagination links","Hypermedia","Link relations"]},{"id":"rfc-8594","name":"RFC 8594","title":"The Sunset HTTP Header Field","description":"Defines the Sunset header for deprecation communication. Format: Sunset: Sat, 31 Dec 2024 23:59:59 GMT. Used with Deprecation header for API lifecycle management.","url":"https://datatracker.ietf.org/doc/html/rfc8594","usedFor":["API deprecation","Lifecycle management"],"example":"Sunset: Sat, 31 Dec 2024 23:59:59 GMT"},{"id":"rfc-9110","name":"RFC 9110","title":"HTTP Semantics","description":"Current HTTP semantics specification (obsoletes RFC 7230-7235). Defines methods (GET, POST, PUT, PATCH, DELETE), status codes, headers. Source of truth for HTTP method properties (safe, idempotent).","url":"https://datatracker.ietf.org/doc/html/rfc9110","usedFor":["HTTP methods","Status codes","Method semantics"]},{"id":"rfc-9111","name":"RFC 9111","title":"HTTP Caching","description":"Defines HTTP caching mechanisms. Cache-Control, ETag, If-None-Match, If-Match headers. Basis for caching and conditional request guidelines.","url":"https://datatracker.ietf.org/doc/html/rfc9111","usedFor":["Caching","ETags","Conditional requests"]},{"id":"rfc-7519","name":"RFC 7519","title":"JSON Web Token (JWT)","description":"Compact, URL-safe token format. Structure: header.payload.signature. Used for access tokens and ID tokens in OAuth 2.0 and OpenID Connect.","url":"https://datatracker.ietf.org/doc/html/rfc7519","usedFor":["Access tokens","ID tokens","Authentication"]}],"links":{"self":{"href":"/v1/standards/rfc"},"parent":{"href":"/v1/standards"}}}