API v1

API para desenvolvedores e assistentes de IA

Crie e gerencie páginas (link na bio, cartão digital, catálogo, agendamento), imagens e links curtos na Comunidade SuperEmpreendedor, em nome de um usuário, sempre com a autorização dele por e-mail. É gratuito.

Arquivos para máquinas: openapi.json · llms.txt · schema dos blocos

Como funciona o consentimento

  1. O assistente só chama /agent/signup depois que o usuário pediu e informou nome, e-mail e telefone.
  2. Enviamos um e-mail ao usuário: “o assistente X quer criar/acessar sua conta”. Ele clica em Autorizar (e define a senha, se a conta é nova).
  3. Enquanto não autoriza, o assistente só consegue montar rascunhos numa conta nova. Nada vai ao ar e nenhum link curto é criado antes da confirmação do e-mail.
  4. O dono vê e revoga todos os acessos em Comunidade › Estúdio › Acessos de IA e API. A equipe do SuperEmpreendedor modera denúncias e pode suspender páginas e chaves.

Início rápido

# 1) cadastro (com o consentimento do usuário)
curl -X POST https://superempreendedor.com/api/v1/agent/signup -H 'Content-Type: application/json' -d '{
  "agent_name": "Meu Assistente",
  "name": "Maria Souza", "email": "maria@exemplo.com", "phone": "(92) 99999-8888",
  "accept_terms": true, "user_authorized": true }'
# → { "ok": true, "token": "sea_…", "status": "pending_owner_approval", … }

# 2) montar o rascunho
curl -X POST https://superempreendedor.com/api/v1/sites -H 'Authorization: Bearer sea_…' -H 'Content-Type: application/json' -d '{
  "kind": "blank", "title": "Doces da Maria", "slug": "doces-da-maria",
  "theme": { "primary": "#be185d", "bg": "#fff1f2", "text": "#4c0519", "font": "rounded", "radius": "pill" },
  "blocks": [
    { "type": "hero", "props": { "title": "Doces da Maria", "subtitle": "Brigadeiros e bolos no pote em Manaus" } },
    { "type": "products", "props": { "title": "Cardápio", "number": "(92) 99999-8888", "items": [ { "name": "Brigadeiro gourmet", "price": "R$ 4,50" } ] } },
    { "type": "whatsapp", "props": { "number": "(92) 99999-8888", "label": "Fazer encomenda" } } ] }'

# 3) depois que o usuário autorizar por e-mail
curl -X POST https://superempreendedor.com/api/v1/sites/{id}/publish -H 'Authorization: Bearer sea_…'

Endpoints

MétodoCaminhoAcessoO que faz
POST/api/v1/agent/signupSem chaveCria a conta do usuário (ou pede acesso a uma conta existente). Envia e-mail ao usuário. Devolve uma chave.
GET/api/v1/agent/statusChaveMostra se o usuário já autorizou, se o e-mail foi confirmado e o que a chave pode fazer.
GET/api/v1/schemaSem chaveTipos de bloco, modelos, opções de tema e limites.
GET/api/v1/meChaveDados da conta e limites de uso.
GET/api/v1/sitesChaveLista os sites da conta.
POST/api/v1/sitesChaveCria um site (kind, title, slug, theme, blocks). Nasce como rascunho.
GET/api/v1/sites/{id}ChaveLê um site.
PUT/api/v1/sites/{id}ChaveAtualiza título, endereço, tema e blocos.
DELETE/api/v1/sites/{id}ChaveExclui o site.
POST/api/v1/sites/{id}/publishChave + e-mail confirmadoPublica o site.
POST/api/v1/sites/{id}/unpublishChaveTira do ar (volta a rascunho).
POST/api/v1/assetsChaveEnvia uma imagem (JSON com data_base64, ou multipart "file"). Devolve o id para usar nos blocos.
GET/api/v1/assetsChaveLista as imagens enviadas.
POST/api/v1/linksChave + e-mail confirmadoCria um link curto.
GET/api/v1/linksChaveLista os links curtos.
GET/api/v1/links/{id}/statsChaveCliques dos últimos 30 dias.
DELETE/api/v1/links/{id}ChaveExclui um link curto.

Blocos disponíveis

typePara quêprops
heroCabeçalho (nome, frase, foto)title texto até 80
subtitle texto até 200
avatar id de imagem enviada (opcional)
cover id de imagem enviada (opcional)
align center|left
textTextoheading texto até 100
body texto até 2000
align left|center
buttonBotão de linklabel texto até 60
url https://… ou mailto: ou tel:
style filled|outline
linksLista de botões (link na bio)items [{label, url}] até 20
imageImagemasset id de imagem enviada
caption texto até 140
url link ao clicar (opcional)
galleryGaleriaassets [id de imagem] até 12
socialRedes sociaisinstagram usuário
tiktok usuário
youtube @canal
facebook página
linkedin perfil
x usuário
whatsapp número com DDD
email e-mail
site https://…
whatsappBotão do WhatsAppnumber com DDD
message mensagem pronta até 300
label texto do botão
videoVídeo do YouTubeurl link do YouTube
caption texto
productsProdutos e serviços (vitrine)title texto
number WhatsApp para pedidos
items [{name, price (texto), desc, asset (id opcional), url (opcional)}] até 24
catalogCatálogo ligado ao Super-PDV do donotitle texto
limit 3 a 48
number WhatsApp
show_price 0|1
bookingAgendamento onlinetitle texto
services [{name, minutes 10-480, price (texto)}] até 8
days {"0".."6": {from:"09:00", to:"17:00"}} (0=domingo)
notice texto
contactFormulário de contatotitle texto
button texto
faqPerguntas frequentestitle texto
items [{q, a}] até 12
testimonialsDepoimentos (somente reais)title texto
items [{name, text}] até 8
addressEndereço e horáriotitle texto
address texto
hours texto
vcardCartão de visita (salvar contato + QR)name
role
company
phone
email
website
address
dividerEspaço/linhasize s|m|l
line 0|1

Servidor MCP

Para assistentes que falam MCP (Model Context Protocol) há um servidor HTTP em https://superempreendedor.com/mcp (JSON-RPC 2.0). Configure o cabeçalho Authorization: Bearer sea_… no cliente. Ferramentas: create_account, get_schema, account_status, get_account, list_sites, get_site, create_site, update_site, publish_site, unpublish_site, delete_site, upload_image, list_images, create_short_link, list_short_links, short_link_stats, delete_short_link. As regras de consentimento e o limite de 30 chamadas por minuto por chave são os mesmos da API.

Regras e limites

Erros vêm em JSON: {"ok":false,"error":{"code","message","hint"}}. Códigos comuns: missing_token, pending_approval, email_not_verified, validation_error, rate_limited.

Segurança e privacidade

Dúvidas ou parcerias: comercial@superempreendedor.com