DOCUMENTAÇÃO

Documentação para IA

Vibecoding com Certillion

Está usando Cursor, Claude Code, Codex, Windsurf, Copilot, Lovable, Antigravity ou qualquer outro assistente com IA para desenvolver sua integração? Disponibilizamos um kit de documentação para IA que ensina seu assistente a integrar a API Certillion de assinatura digital ICP-Brasil de forma correta e econômica — sem precisar adivinhar parâmetros, sem gerar código com erros silenciosos de cobrança, e com os pontos de atenção mais importantes já no contexto.

Você adiciona os arquivos do kit ao contexto do seu assistente e ele passa a conhecer a API como um desenvolvedor experiente nela: o fluxo de autenticação OAuth2, os padrões de assinatura, as regras de custo, o tratamento correto de erros e as boas práticas de implementação.

📦 O kit está no GitHub:
github.com/certillion/ai-integration-kit
Lá você encontra todos os arquivos, o passo a passo de instalação em cada ferramenta e instruções de uso atualizadas.


O que o kit contém

São arquivos complementares, cada um com um papel — instalados juntos, dão à IA cobertura completa para a integração:

  • Skill de regras — as regras obrigatórias que todo código de integração deve seguir (separação dos passos de assinatura, tratamento de erro por passo, guardrail de ambiente de teste, escolha do padrão de assinatura, e mais).
  • Guia de integração — explica os fluxos, o porquê das decisões, a lógica de custo e o diagnóstico dos problemas mais comuns.
  • Schema OpenAPI 3.0 — a referência canônica e tipada de todos os endpoints; importável em Postman/Insomnia e em geradores de SDK.
  • Exemplos de código — o fluxo essencial de assinatura pronto em Node.js, Python, PHP, Java e Ruby.

Todo o detalhamento — descrição de cada arquivo, regras, exemplos e instruções — está no repositório, mantido sempre atualizado.


Como começar

1. Acesse o repositório em github.com/certillion/ai-integration-kit e siga o guia de instalação do README — ele cobre os principais assistentes (Claude Code, Codex, Cursor, Windsurf, Copilot, Lovable, Antigravity). Na maioria deles, um único arquivo AGENTS.md na raiz do projeto já configura tudo. No Lovable, você pode usar o GitHub sync (o Lovable lê o AGENTS.md do repositório automaticamente) ou colar o conteúdo da skill no Project Knowledge (Settings → Knowledge), sem precisar de GitHub.

2. Solicite suas credenciais de teste pela página de Contato. Nossa equipe envia as credenciais e orienta sobre as condições de uso durante o período de integração.

3. Peça a integração ao seu assistente. Com o kit no contexto e as credenciais configuradas, descreva o que seu sistema precisa fazer — a IA já conhece o fluxo, as restrições de custo e os pontos de atenção, e gera código correto desde o início.


Compatível com seu assistente

O kit funciona com os principais assistentes de IA do mercado. A configuração se apoia no AGENTS.md, um padrão aberto lido nativamente pela maioria das ferramentas:

AssistenteComo configurar
Claude CodeCLAUDE.md (importando AGENTS.md) ou como Skill
OpenAI CodexAGENTS.md na raiz do projeto
Cursor.cursor/rules/ ou AGENTS.md
Windsurf.windsurf/rules/ ou AGENTS.md
GitHub Copilot.github/copilot-instructions.md ou AGENTS.md
LovableGitHub sync: AGENTS.md na raiz; ou Project Knowledge (Settings → Knowledge)
Google AntigravityAGENTS.md, .agents/rules/ ou como Skill

O passo a passo detalhado de cada uma está no README do repositório.

Os artefatos foram elaborados pela equipe Certillion com base na experiência de integração da plataforma e também na documentação oficial da API: visão geral, tutoriais e referência da API.

Kit de documentação para IA — versão 0.2-beta.

Shopping Basket