Skip to main content

​
O que é a Cakto?

A Cakto é uma plataforma de pagamentos moderna voltada para negócios digitais, que simplifica a gestão e o recebimento de transações online com segurança, agilidade e foco na experiência do usuário.

​
Visão Geral

A API Cakto é uma API REST que permite integrar sua aplicação com a plataforma Cakto, possibilitando o gerenciamento via código de produtos, ofertas, pedidos e outras funcionalidades.

​
URL Base

Todas as requisições devem ser feitas utilizando esta URL base: 
    https://api.cakto.com.br/

​
Pré-requisitos

Para começar a usar a API, você precisa:

​
Autenticação

Todas as requisições requerem autenticação OAuth2. O processo envolve:
  1. Enviar suas credenciais para o endpoint de token
  2. Receber um access_token com validade de algumas horas
  3. Usar o token em todas as requisições subsequentes

​
Escopos de Acesso

Ao criar sua chave de API, você pode selecionar os escopos que sua aplicação tem acesso, definindo especificamente o grau de acesso e os recursos acessados.

​
Formato das Requisições

Todas as requisições autenticadas utilizam o header HTTP Authorization: 
Authorization: Bearer {seu_access_token}
Content-Type: application/json

Guia Completo de Autenticação

Veja o passo a passo detalhado com exemplos de código

​
Paginação e Filtros

Endpoints de listagem suportam parâmetros de URL para paginação, busca, filtros e ordenação: 
# Paginação
?page=2&limit=50

# Busca
?search=curso

# Filtros
?status=active&type=unique

# Ordenação
?ordering=-price

​
Formato das Respostas

As respostas retornam dados em formato JSON. Listagens são sempre paginadas: 
    {
    "count": 42,
    "next": "https://api.cakto.com.br/api/products/?page=4",
    "previous": "https://api.cakto.com.br/api/products/?page=2",
    "results": [...]
    }

​
Códigos de Status HTTP

CódigoDescrição
200Sucesso
201Recurso criado
204Sucesso sem conteúdo
400Requisição inválida
401Não autenticado
403Sem permissão
404Não encontrado

​
Próximos Passos

Autenticação

Aprenda a autenticar e gerenciar tokens OAuth2

Referência da API

Explore todos os endpoints disponíveis

Produtos

Gerencie seus produtos

Suporte

Entre em contato com nossa equipe