API pública v1

Documentação da API

Use a API para criar links curtos, consultar links existentes e acompanhar estatísticas básicas. Os exemplos abaixo mostram o caminho mais direto para começar.

Precisa do contrato completo?

O arquivo OpenAPI traz todos os campos, respostas e formatos aceitos.

Abrir OpenAPI JSON

Autenticação

Envie sua chave de acesso no cabeçalho Authorization em todas as chamadas protegidas.

Authorization: Bearer sk_suafot_xxxxx

Criar link

Este exemplo cria um link curto para uma galeria e evita duplicidade usando Idempotency-Key.

curl -X POST https://api.sua.fot.br/v1/links \
  -H "Authorization: Bearer sk_suafot_xxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gallery_123" \
  -d '{
    "destination_url": "https://galeria.exemplo.com/casamento-ana-joao",
    "slug": "ana-joao",
    "title": "Galeria Ana e João",
    "campaign": "casamento"
  }'

Chamadas disponíveis

Caminhos principais para verificar a API, criar links e acompanhar estatísticas.

GET /healthPOST /linksGET /linksGET /links/{id}PATCH /links/{id}DELETE /links/{id}GET /links/{id}/stats