# Selectwin API > A Selectwin API é uma API REST de grau financeiro para pagamentos no Brasil (cartão de crédito, PIX e boleto), além de clientes, carteiras, saques, recebíveis, assinaturas, produtos, cupons, checkouts e webhooks. Toda a comunicação usa JSON sobre HTTPS com autenticação por chave de API. ## Fundamentos técnicos Toda a comunicação é REST com payloads JSON e autenticação via header `SelectKey`. A URL base de produção é `https://api.selectwin.io/v1`. Chaves de sandbox começam com `sl_test_` e chaves de produção com `sl_live_`. Valores monetários são expressos em **centavos** (inteiros, ex.: R$ 50,00 = `5000`) e a moeda é **BRL**. Datas seguem ISO 8601 em UTC. Todos os identificadores seguem o formato `prefixo_valor` (ex.: `cus_...`, `tra_...`) e devem ser tratados como strings opacas. A especificação OpenAPI completa está em [/api-specs/openapi.json](/api-specs/openapi.json). ## Comece aqui - [Introdução à API Selectwin](/docs/reference/introducao): A Selectwin API foi desenvolvida seguindo os melhores padrões REST, proporcionando uma integração simples e eficiente para qualquer aplicação. As operações são realizadas por meio de requisições aos e - [Autenticação](/docs/reference/autenticacao): A API Selectwin utiliza um sistema de autenticação baseado em chaves API (API Keys), proporcionando um método simples e seguro para autenticar suas requisições. Este sistema elimina a necessidade de g - [Quickstart](/docs/reference/quickstart): Sua primeira cobrança em poucos minutos. Você vai: autenticar, criar uma transação PIX, e receber a - [Convenções da API](/docs/reference/convencoes): Esta página reúne as convenções transversais que valem para todos os recursos da API Selectwin. - [Recursos da API](/docs/reference/recursos): A API Selectwin é organizada em torno de recursos RESTful, onde cada recurso representa uma entidade de negócio específica. Todos os recursos seguem uma convenção de nomeação consistente e são acessad ## Conceitos essenciais - [Tratamento de Erros](/docs/reference/erros): A API Selectwin utiliza códigos de status HTTP padrão e uma estrutura de resposta de erro consistente para comunicar problemas durante o processamento das requisições. Este documento detalha os difere - [Catálogo de Códigos de Erro](/docs/reference/codigos-de-erro): Este catálogo lista os valores de error.code que a API pode retornar, agrupados por status HTTP e - [Recusas de Pagamento (Erros de Cartão)](/docs/reference/recusas-de-pagamento): Quando uma cobrança no cartão é recusada pelo emissor/adquirente (ex.: fundos insuficientes, cartão vencido, senha incorreta), a API retorna HTTP 402 com um envelope de erro específico de pagamento. D - [Idempotency Key](/docs/reference/idempotencia): A API Selectwin suporta chaves de idempotência (Idempotency Keys) para garantir que requisições sensíveis não sejam processadas mais de uma vez, mesmo em caso de falhas de rede, timeouts ou retentativ - [Paginação](/docs/reference/paginacao): A API Selectwin utiliza um sistema de paginação consistente em todos os endpoints que retornam listas de recursos. Este mecanismo permite controlar a quantidade de dados retornados em cada requisição, - [API Limits](/docs/reference/limites): A Selectwin implementa limites de uso na API para garantir a estabilidade, disponibilidade e desempenho consistente da plataforma para todos os integradores. Este documento detalha os diferentes tipos - [Proibição de Polling](/docs/reference/proibicao-de-polling): A API Selectwin proíbe explicitamente o uso de polling (consultas recorrentes e frequentes) como método para obter atualizações de status de recursos. Esta política foi implementada para garantir a es - [Metadata](/docs/reference/metadata): A funcionalidade de Metadata da Selectwin API permite anexar informações adicionais personalizadas aos principais recursos da plataforma. Esta característica oferece flexibilidade para armazenar dados - [Versionamento & Changelog](/docs/reference/versionamento): A versão está embutida na URL base: - [Segurança e Conformidade PCI DSS](/docs/reference/seguranca-pci): A Selectwin implementa rigorosas medidas de segurança em conformidade com o Padrão de Segurança de Dados da Indústria de Cartões de Pagamento (PCI DSS), garantindo a proteção adequada das informações - [Payment Orchestration](/docs/reference/payment-orchestration): A Selectwin oferece uma solução robusta de orquestração de pagamentos (Payment Orchestration) automática que gerencia múltiplas formas de pagamento, rotas de processamento e regras de negócio através - [Shipping](/docs/reference/shipping): O objeto Shipping na API Selectwin representa as informações de entrega associadas a uma transação. Esta estrutura permite armazenar e gerenciar todos os detalhes logísticos de uma venda, desde o ende - [Card For Test](/docs/reference/cartoes-de-teste): A funcionalidade de Card For Test da Selectwin API oferece cartões de teste pré-configurados para simular diversos cenários de transações. Esta característica permite testar integrações e fluxos de pa ## Clientes - [Visão geral](/docs/guide/customers/overview): O recurso Clientes (customer) representa as pessoas físicas ou jurídicas que compram de você ou interagem com a sua plataforma. Um cliente reúne identidade (nome, documento, e-mail, telefone), seus en - [Criar um cliente](/docs/guide/customers/create): Cria um novo cliente (um "customer") na sua conta Selectwin a partir do nome, documento, e-mail e telefone. Use este endpoint para registrar a pessoa que vai pagar antes de cobrá-la, vincular cartões - [Consultar um cliente](/docs/guide/customers/read): Recupera a ficha completa de um cliente pelo seu ID público (cus...), incluindo dados pessoais, documento, telefone, e-mails adicionais, metadados e as relações vinculadas (transações recentes, endere - [Atualizar um cliente](/docs/guide/customers/update): Atualize os dados de um cliente existente a partir do seu id. Use PUT quando quiser sobrescrever o conjunto de campos permitido de uma vez, ou PATCH quando quiser alterar apenas alguns campos sem reen - [Listar clientes](/docs/guide/customers/list): Recupera uma coleção paginada de clientes cadastrados na sua conta, com busca, filtros e ordenação. É o ponto de partida para telas administrativas, sincronização de CRM, relatórios e para encontrar o - [Excluir um cliente](/docs/guide/customers/delete): Remove permanentemente um cliente da sua conta pelo ID. Use quando precisar apagar um cadastro criado por engano, eliminar duplicidades ou atender a um pedido de exclusão de dados (LGPD/GDPR). A opera ## Endereços - [Visão geral](/docs/guide/addresses/overview): O recurso Endereços (Address) guarda localizações físicas — rua, número, bairro, cidade, estado, país e CEP — vinculadas a um titular (um cliente, por exemplo). Use-o para registrar endereços de entre - [Criar um endereço](/docs/guide/addresses/create): Cria um novo endereço e o vincula ao contexto autenticado (o cliente ou a empresa dona da chave de API). Use esta operação para registrar endereços de entrega, cobrança ou cadastro a partir de um chec - [Consultar um endereço](/docs/guide/addresses/read): Recupera um endereço específico pelo seu identificador público (addr...), devolvendo o objeto completo — componentes do endereço, coordenadas, dono associado e links HATEOAS. Use quando precisar exibi - [Atualizar um endereço](/docs/guide/addresses/update): Atualize os dados de um endereço já cadastrado a partir do seu identificador único (addr). Use para corrigir um logradouro digitado errado, completar um cadastro parcial ou normalizar o CEP depois de - [Listar endereços](/docs/guide/addresses/list): Recupere uma lista paginada de endereços cadastrados, com filtros por cliente e por intervalo de datas. Use para montar telas de seleção de endereço no checkout, exibir os endereços de um cliente no p - [Excluir um endereço](/docs/guide/addresses/delete): Remove permanentemente um endereço da sua conta, identificado pelo ID público (addr...). Use quando o registro não for mais necessário — por exemplo, ao limpar cadastros duplicados, remover um endereç ## Cartões - [Visão geral](/docs/guide/cards/overview): O recurso Cartões guarda, de forma tokenizada, os cartões de crédito/débito dos seus clientes para que você possa cobrá-los depois sem precisar manipular os dados sensíveis a cada compra. Tokenizar si - [Criar um cartão](/docs/guide/cards/create): Cadastre um cartão de crédito ou débito de um cliente e receba de volta um token seguro (card…) que você usa em cobranças futuras sem nunca mais tocar nos dados sensíveis do cartão. Use este endpoint - [Consultar um cartão](/docs/guide/cards/read): Recupera os dados de um cartão tokenizado a partir do seu identificador. A resposta traz informações seguras (apenas dígitos parciais, nunca o número completo nem o CVV) e o estado atual do cartão — i - [Listar cartões](/docs/guide/cards/list): Recupera a lista de cartões tokenizados da sua conta, em formato paginado, com filtros por titular (cliente), por ID de cartão e por intervalo de datas. Use esta rota para montar telas de "meus cartõe - [Excluir um cartão](/docs/guide/cards/delete): Remove permanentemente um cartão tokenizado da conta, identificado pelo seu cardId. Use quando o cliente pedir para apagar um meio de pagamento, quando um cartão estiver comprometido ou ao limpar cart ## Transações - [Visão geral](/docs/guide/transactions/overview): Uma transação representa uma cobrança na Selectwin: o registro do pagamento de um cliente por cartão, Pix, boleto ou Nupay, com seu valor, status, recebíveis e histórico. Este é o recurso central da A - [Criar uma transação](/docs/guide/transactions/create): Crie uma cobrança enviando o meio de pagamento (cartão, Pix, boleto, NuPay ou débito), o valor e os dados do cliente para POST /v1/transactions. A Selectwin processa o pagamento junto ao adquirente e - [Consultar uma transação](/docs/guide/transactions/read): Recupera o objeto completo de uma transação a partir do seu ID (tra): status atual, valores, meio de pagamento, cliente, itens, recebíveis (receivables), splits, reembolsos, disputas e a linha do temp - [Listar transações](/docs/guide/transactions/list): Recupere uma página de transações da sua conta, filtrando por status, método de pagamento, cliente, período e outros critérios. É a principal visão de vendas e pagamentos: use-a para montar relatórios - [Capturar uma transação](/docs/guide/transactions/capture): Captura confirma a cobrança de uma transação de cartão que foi pré-autorizada (o valor ficou reservado no cartão do cliente, mas ainda não foi efetivamente debitado). Use a captura quando seu fluxo de - [Reembolsar uma transação](/docs/guide/transactions/refund): Devolve ao cliente o valor de uma transação já aprovada, total ou parcialmente, respeitando os prazos e limites do meio de pagamento. Use quando precisar estornar uma compra — por desistência, produto - [Contestações e disputas](/docs/guide/transactions/dispute): Registra uma disputa (contestação/chargeback) para uma transação e envia, de uma só vez, os documentos de defesa que comprovam a legitimidade da cobrança. Use quando o titular do cartão questiona uma ## Assinaturas - [Visão geral](/docs/guide/subscriptions/overview): O recurso de Assinaturas (Subscriptions) orquestra cobranças recorrentes de ponta a ponta: ele agrupa um cliente, um ou mais itens recorrentes e um método de pagamento, e a Selectwin gera e cobra auto - [Criar uma assinatura](/docs/guide/subscriptions/create): Cria uma assinatura recorrente (mensal, anual, etc.) para um cliente, cobrando-o automaticamente a cada ciclo. O preço não é informado por você: ele vem das variantes referenciadas em items — esse é o - [Consultar uma assinatura](/docs/guide/subscriptions/read): Recupera o estado completo e atual de uma assinatura pelo seu id, incluindo o ciclo de cobrança vigente, o cliente, os itens, o desconto, os splits e os links de ações disponíveis. Use sempre que prec - [Listar assinaturas](/docs/guide/subscriptions/list): Retorna uma lista paginada das suas assinaturas, com filtros por status, cliente, referência externa e intervalo de datas. Use esta operação para painéis de cobrança recorrente, conciliação e acompanh - [Cancelar uma assinatura](/docs/guide/subscriptions/cancel): Encerra uma assinatura para que ela pare de gerar e cobrar novos ciclos. O cancelamento pode ser imediato ou agendado para o fim do ciclo atual, conforme a política configurada na sua conta; em ambos - [Ciclos de cobrança](/docs/guide/subscriptions/cycles): Cada assinatura é cobrada em ciclos: períodos de cobrança recorrentes (por exemplo, um mês) com data de início, fim, vencimento e status próprios. A Selectwin gera e cobra os ciclos automaticamente; e - [Itens da assinatura](/docs/guide/subscriptions/items): Os itens são as linhas que compõem o que uma assinatura cobra a cada ciclo: cada item referencia um produto (em geral uma variante recorrente, var...), com uma quantidade e um preço unitário. Use este - [Splits de recebíveis](/docs/guide/subscriptions/splits): Os splits dividem automaticamente a receita de cada cobrança recorrente da assinatura entre você (o merchant) e outros destinatários — sócios, parceiros, afiliados ou subcontas. Você define quem receb ## Recebíveis - [Visão geral](/docs/guide/receivables/overview): Um recebível (receivable) representa um valor a receber na sua conta, gerado automaticamente quando uma transação é aprovada. Cada parcela de uma venda e cada destinatário de um split viram recebíveis - [Listar recebíveis](/docs/guide/receivables/list): Retorna uma lista paginada dos seus recebíveis (valores a receber gerados por transações aprovadas), com filtros por status, por estado de liberação e por intervalo de datas. É o endpoint que você usa - [Métricas e análises](/docs/guide/receivables/analytics): Retorna um recorte resumido dos seus recebíveis dentro de um intervalo de datas obrigatório, voltado a relatórios, dashboards e conciliação agregada. A resposta vem na chave list (não data) e não é pa ## Saques - [Visão geral](/docs/guide/withdrawals/overview): Um saque (withdrawal) transfere o dinheiro disponível do seu saldo na Selectwin para uma carteira bancária (wallet) que você cadastrou previamente. Use este recurso para resgatar o que vendeu: você so - [Criar um saque](/docs/guide/withdrawals/create-withdrawal): Solicita a transferência de fundos disponíveis do seu saldo na Selectwin para uma carteira bancária cadastrada. O saque é criado com status pending e segue de forma assíncrona por etapas de verificaçã - [Consultar um saque](/docs/guide/withdrawals/read-withdrawal): Recupera todos os detalhes de um saque específico a partir do seu identificador (cash…): valor, status atual, método de transferência, taxa aplicada e os carimbos de tempo de criação, aprovação e paga - [Listar saques](/docs/guide/withdrawals/list-withdrawals): Recupera, de forma paginada, o histórico de saques (repasses bancários) da sua conta, com filtros por status, método de pagamento, período e identificador. Use este endpoint para acompanhar repasses, ## Finanças - [Visão geral](/docs/guide/finance/overview): O recurso de Finanças reúne os endpoints de leitura que mostram a posição financeira da sua conta na Selectwin: quanto você tem disponível e o que está retido (saldo), o seu indicador de risco perante - [Consultar saldo](/docs/guide/finance/balance): O endpoint de saldo retorna a fotografia financeira atual de uma conta: quanto já está disponível para saque, quanto ainda está pendente de liquidação, quanto está bloqueado e qual plano de taxas está - [Listar recebíveis](/docs/guide/finance/list-receivables): Lista os recebíveis (valores a receber) da sua conta — cada parcela que uma transação gera e que será liquidada no seu saldo. Use este endpoint para acompanhar o que já caiu, o que ainda está pendente ## Carteiras - [Visão geral](/docs/guide/wallets/overview): Uma carteira (wallet) é uma conta bancária que você cadastra na Selectwin para receber saques do seu saldo. Você registra os dados bancários uma vez, marca uma carteira como principal e, a partir daí, - [Criar uma carteira](/docs/guide/wallets/create-wallet): Cadastra uma nova carteira (conta bancária) para a sua conta de recebimento, informando os dados bancários para onde os saques serão enviados. Use este endpoint quando precisar registrar uma conta de - [Consultar uma carteira](/docs/guide/wallets/read-wallet): Recupera todos os detalhes de uma carteira (conta bancária) cadastrada, a partir do seu identificador único. Use esta consulta para conferir os dados bancários antes de realizar um saque, verificar qu - [Listar carteiras](/docs/guide/wallets/list-wallets): Liste as carteiras (contas bancárias) cadastradas na sua conta para recebimento e saque, com paginação, ordenação e filtros por ID ou por data. Use esta operação para montar telas de seleção de conta, - [Excluir uma carteira](/docs/guide/wallets/delete-wallet): Remove permanentemente uma carteira (conta bancária) cadastrada para recebimentos e saques. Use quando uma conta não será mais usada como destino de liquidação. A operação é irreversível e exige que n ## Checkouts - [Visão geral](/docs/guide/checkouts/overview): Checkouts é o recurso que gera payment links: páginas de pagamento hospedadas pela Selectwin, com URL pronta para compartilhar, para vender uma ou mais variantes de produto sem você precisar construir - [Links de pagamento](/docs/guide/checkouts/payment-links): Um Payment Link é uma página de checkout hospedada e compartilhável — uma URL pronta e assinada que você gera para vender uma ou mais variantes de produto sem precisar construir o próprio fluxo de pag - [Sessões de checkout](/docs/guide/checkouts/sessions): Uma Checkout Session é um carrinho de compra hospedado pela Selectwin: você cria a sessão pela API, recebe uma URL de checkout pronta e a entrega ao comprador (redirect, e-mail, SMS ou QR Code). O com ## Cupons - [Visão geral](/docs/guide/coupons/overview): Cupons são descontos promocionais (percentuais ou de valor fixo) que você cria na sua conta e aplica em checkouts e campanhas. Cada cupom tem um código que o cliente digita e regras de elegibilidade ( - [Criar um cupom](/docs/guide/coupons/create): Cria um novo cupom de desconto, definindo o código que o cliente digita no checkout, o tipo e o valor do desconto, e as regras que controlam quando ele pode ser usado (validade, valor mínimo de carrin - [Consultar um cupom](/docs/guide/coupons/read): Recupera os dados completos de um cupom de desconto pelo seu ID. Use esta operação sempre que precisar exibir, auditar ou conferir o estado atual de um cupom — por exemplo, ver quantas vezes ele já fo - [Atualizar um cupom](/docs/guide/coupons/update): Atualiza parcialmente um cupom existente: você envia apenas os campos que quer mudar, e tudo o que ficar de fora permanece exatamente como estava. Use esta operação para ligar/desligar uma campanha, c - [Listar cupons](/docs/guide/coupons/list): Liste os cupons da sua conta com paginação e filtros (nome, código, tipo de desconto, status e intervalo de datas). Use esta operação para popular telas de administração, montar relatórios de campanha - [Excluir um cupom](/docs/guide/coupons/delete): Remove permanentemente um cupom da sua conta. Depois de excluído, o código deixa de existir e não pode mais ser aplicado em nenhum checkout. Use quando uma campanha terminou de vez e você quer remover ## Produtos - [Visão geral](/docs/guide/products/overview): O recurso Produtos (Products) é o seu catálogo na Selectwin. Cada produto agrupa uma ou mais Variantes (Variants), e é a variante que carrega o preço e as regras de cobrança — é ela que você referenci - [Criar um produto](/docs/guide/products/create): Cria um produto no seu catálogo e, na mesma requisição, pelo menos uma variante com preço. O produto é o "guarda-chuva" comercial (nome, tipo, garantia); a variante é o item vendável de fato, com pric - [Consultar um produto](/docs/guide/products/read): Busca um produto do catálogo pelo seu ID e devolve a representação completa, incluindo todas as variantes embutidas com seus preços (pricing). Use quando precisar exibir o produto num checkout, painel - [Atualizar um produto](/docs/guide/products/update): Atualize os dados de um produto existente — nome, descrição, categoria, status (enabled), garantia, página de vendas e demais campos do "cabeçalho" do produto — enviando uma requisição PUT ou PATCH co - [Listar produtos](/docs/guide/products/list): Liste os produtos do seu catálogo com filtros (slug, categoria, nome, idioma, datas) e paginação. Use a lista paginada no dia a dia — para alimentar tabelas, telas administrativas ou buscas — e a list - [Variantes de produto](/docs/guide/products/variants): As variantes são as versões vendáveis de um produto(/docs/guide/products/overview): cada uma carrega seu próprio preço, SKU e regras de cobrança. Esta página mostra como criar, listar, consultar, atua ## Endpoints - [Visão geral](/docs/guide/webhook-endpoints/overview): Um Webhook Endpoint é uma URL do seu sistema que a Selectwin registra para entregar notificações automáticas (chamadas webhooks) sempre que algo acontece na sua conta — uma transação aprovada, um saqu - [Criar um endpoint](/docs/guide/webhook-endpoints/create): Registre uma URL sua para receber webhooks — notificações HTTP que a Selectwin envia automaticamente quando algo acontece na sua conta (uma transação aprovada, um saque concluído etc.). Em vez de fica - [Consultar um endpoint](/docs/guide/webhook-endpoints/read): Recupera o objeto completo de um único webhook endpoint pelo seu id (wbe…). Use esta operação quando precisar dos campos que não vêm na listagem — como authorization (cabeçalho que a Selectwin envia a - [Atualizar um endpoint](/docs/guide/webhook-endpoints/update): Altere a configuração de um endpoint de webhook existente — sua URL de destino, os tipos de evento inscritos, o cabeçalho de autenticação ou os metadados. Use quando precisar redirecionar entregas apó - [Excluir um endpoint](/docs/guide/webhook-endpoints/delete): Remove permanentemente um endpoint de webhook (a URL cadastrada para receber notificações da Selectwin). A partir da exclusão, aquela URL deixa de receber qualquer evento — use quando uma integração f - [Listar endpoints](/docs/guide/webhook-endpoints/list): Recupera, de forma paginada, todos os webhook endpoints (URLs cadastradas para receber notificações de eventos) da sua conta. Use esta operação para auditar suas integrações, descobrir o id de cada en - [Analisar endpoints](/docs/guide/webhook-endpoints/analyze): Recupere as tentativas de entrega mais recentes de um endpoint de webhook para diagnosticar a saúde da sua integração: quais disparos chegaram ao seu servidor, quais falharam e quando foi a última ten ## Eventos - [Visão geral](/docs/guide/webhook-events/overview): Um Webhook Event é o registro de uma notificação que a Selectwin gerou a partir de algo que aconteceu na sua conta (uma transação aprovada, um cliente criado, um recebível pago) e tentou entregar aos - [Listar eventos](/docs/guide/webhook-events/list): Liste o histórico de eventos de webhook da sua conta — as notificações que a Selectwin gerou (ex.: transaction.approved) junto com o registro de cada tentativa de entrega aos seus endpoints. Use esta - [Reenviar eventos](/docs/guide/webhook-events/resend): Reenviar um evento dispara uma nova tentativa de entrega de um evento de webhook que já foi gerado, usando o id do evento. É a forma manual de recuperar uma notificação que não chegou ao seu sistema — - [Verificar a assinatura (HMAC)](/docs/guide/webhook-events/verifying-signatures): A cada webhook entregue, a Selectwin assina o corpo da requisição com HMAC-SHA256 e envia o resultado no cabeçalho X-Selectwin-Signature. Recalcular essa assinatura no seu servidor — e só processar o - [Catálogo de eventos](/docs/guide/webhook-events/event-catalog): Esta página é a referência dos tipos de evento que a Selectwin pode entregar aos seus webhook endpoints. Um evento é uma notificação gerada quando algo muda na plataforma (ex.: uma transação é aprovad ## Entregas - [Visão geral](/docs/guide/webhook-dispatches/overview): Um dispatch (entrega) é o registro de uma tentativa de entregar um evento de webhook a um endpoint específico da sua conta. Cada dispatch guarda o resultado da tentativa — status, número de tentativas - [Listar entregas](/docs/guide/webhook-dispatches/list): Liste o histórico de tentativas de entrega (dispatches) dos seus webhooks: cada item registra um evento enviado a um endpoint, o resultado da tentativa e o diagnóstico HTTP do seu servidor. É a ferram - [Métricas e análises](/docs/guide/webhook-dispatches/analytics): Recupere as tentativas de entrega (dispatches) de webhook criadas dentro de um período para medir a saúde da sua integração — taxa de sucesso, falhas e quantas retentativas foram necessárias. É uma op - [Reenviar entregas](/docs/guide/webhook-dispatches/redispatch): Reenvie (redeliver) uma entrega de webhook específica ao endpoint exato que a recebeu, sem afetar as demais entregas do mesmo evento. É o recurso certo para reprocessar uma falha pontual depois de cor ## Casos de uso - [Checkout de e-commerce ponta a ponta](/docs/guide/use-cases/e-commerce-checkout): Tutorial ponta a ponta para integrar o checkout de uma loja virtual com a API Selectwin: você identifica ou cadastra o cliente, opcionalmente tokeniza o cartão, cria a transação (cartão, Pix ou boleto ## Referência da API - [Referência da API](/docs/reference): todos os endpoints, schemas, exemplos e respostas de erro. - [Especificação OpenAPI](/api-specs/openapi.json): o openapi.json completo.