1. REST API Design Rulebook — Mark Masse

Este livro entrega o alicerce conceitual para o design de APIs REST. Ele foca em decisões duráveis que reduzem ambiguidades no contrato entre cliente e servidor.

• Definição de recursos claros e estáveis com URIs intuitivas.
• Semântica de operações via métodos HTTP e códigos de status claros.
• Negotiation de conteúdo para formatos como JSON e XML, conforme necessidade.
• Hipertexto orientado a estado (hipermídia) como forma de guiar clientes, sem acoplamento rígido.

2. RESTful Web APIs — Leonard Richardson, Mike Amundsen e Sam Ruby

Aborda padrões de construção de APIs REST, incluindo uma visão prática da maturidade de APIs e o papel da hipermídia na evolução dos contratos de API.

• Entendimento dos níveis de maturidade de uma API e como avançar de forma segura.
• Boas práticas de modelagem de recursos e de roteamento, com foco em legibilidade.
• Uso criterioso de hiperlinks para orientar navegadores e clientes sem dependência de documentação externa constante.
• Estratégias eficientes de consulta, cache e gestão de metadados de API.

3. Designing Web APIs — Brenda Jin, Saurabh Sahni, Amir Shevat

Guia pragmático para o design de APIs modernas, com foco em contratos estáveis, ergonomia do consumidor e governança de APIs em organizações.

• Concepção de endpoints com contratos estáveis que minimizam breaking changes.
• Estratégias consistentes de autenticação, autorização e controle de acesso.
• Documentação como contrato vivo, mantendo divergência sob controle entre implementação e consumo.
• Práticas de ergonomia de API para desenvolvedores, incluindo mensagens de erro significativas e consistentes.

4. REST in Practice — Jim Webber, Savas Sexipou, Ian Robinson

Casos reais, padrões de implementação e lições aprendidas para construir APIs escaláveis, seguras e fáceis de manter no mundo real.

• Práticas de hypermedia e evolução de APIs sem ruptura de clientes existentes.
• Estratégias de caching, versionamento discreto e observabilidade de APIs.
• Abordagens de segurança, validação de entrada e proteção contra falhas comuns.
• Testes orientados a contrato e validação de contratos com consumidores de API.

Exemplo: OpenAPI simples para um endpoint de usuários

openapi: 3.0.2
info:
  title: Exemplo de API de Usuários
  version: 1.0.0
paths:
  /users:
    get:
      summary: Lista usuários
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'
  /users/{id}:
    get:
      summary: Obter usuário por ID
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        email:
          type: string
      required:
        - id
        - name