aid: restful-apis
name: RESTful APIs
description: >-
  Representational State Transfer (REST) is an architectural style for
  designing networked applications. RESTful APIs use HTTP methods to perform
  CRUD operations and communicate between client and server using stateless,
  cacheable requests with standard conventions. This collection covers RESTful
  API design principles, best practices, standards, tools, and the OpenAPI
  Specification ecosystem.
type: Index
url: https://raw.githubusercontent.com/api-evangelist/restful-apis/refs/heads/main/apis.yml
tags:
  - Architecture
  - HTTP
  - REST
  - Web Services
  - OpenAPI
  - Standards
  - Design
created: '2025-01-01'
modified: '2026-05-02'
specificationVersion: '0.19'
apis: []
artifacts:
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/restful-apis/refs/heads/main/json-schema/restful-apis-resource-schema.json
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/restful-apis/refs/heads/main/json-schema/restful-apis-error-schema.json
  - type: Vocabulary
    url: https://raw.githubusercontent.com/api-evangelist/restful-apis/refs/heads/main/vocabulary/restful-apis-vocabulary.yml
common:
  - type: DomainSecurity
    url: security/restful-apis-domain-security.yml
  - type: Website
    url: https://restfulapi.net/
  - type: OpenAPI Specification
    url: https://spec.openapis.org/oas/latest.html
  - type: RFC 7231 HTTP Semantics
    url: https://datatracker.ietf.org/doc/html/rfc7231
  - type: Roy Fielding REST Dissertation
    url: https://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm
  - type: Richardson Maturity Model
    url: https://martinfowler.com/articles/richardsonMaturityModel.html
  - type: OWASP API Security Top 10
    url: https://owasp.org/www-project-api-security/
  - type: JSON API Specification
    url: https://jsonapi.org/
  - type: HAL Specification
    url: https://stateless.group/hal_specification.html
  - type: Swagger Tools
    url: https://swagger.io/tools/
  - type: Postman REST Client
    url: https://www.postman.com/
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com