Guia de integração do Foolscap

Do zero ao primeiro PDF

Quatro passos, uns cinco minutos.

1. 1

   Crie sua conta

   Acesse dev.foolscap.app.br/login e preencha o nome da empresa, CPF ou CNPJ, celular e e-mail. É tudo que a gente pede — sem cartão, sem formulário quilométrico.

   
2. 2

   Confirme o código do e-mail

   Nada de senha pra decorar (nem vazar): a cada acesso, um código chega no seu e-mail. Digite e pronto — você está no painel.

   
3. 3

   Gere sua API key

   No painel, abra a seção API Keys e crie uma key com um nome que identifique o uso — "producao", por exemplo. Atenção: o segredo fsk_… aparece uma única vez. Copie e guarde num lugar seguro; depois disso, nem a gente consegue vê-lo de novo.

   
4. 4

   Emita o primeiro documento

   Com o SDK oficial de Python, emitir é uma chamada: o render() envia os dados e já devolve o documento pronto — a geração é assíncrona, mas o 202 e o polling ficam por conta dele. Pra lote, o modo async enfileira com render_nowait() e busca depois com wait_for_document(). Prefere integrar sem SDK? A aba curl mostra o que acontece por baixo: o POST /v1/render responde na hora com um document_id e, segundos depois, o GET /v1/documents/{id} devolve o pdf_url.

   Pythoncurl

   SyncAsync

   # pip install foolscap-sdk
   from foolscap_sdk import Foolscap
   
   client = Foolscap(api_key="fsk_...")
   doc = client.render(
       template_id="tpl_contrato",
       data={"contratante": {"nome": "Maria Silva"}},
       document_name="Contrato — Maria Silva",
   )
   print(doc.pdf_url)  # PDF pronto — o SDK cuida do 202 + polling sozinho

   # enfileira e segue a vida — bom pra lote
   pedidos = [client.render_nowait(template_id="tpl_contrato", data=d) for d in lote]
   
   # depois, no seu ritmo:
   for pedido in pedidos:
       doc = client.wait_for_document(pedido.document_id)
       print(doc.pdf_url)

   curl -X POST https://api.dev.foolscap.app.br/v1/render \
     -H 'Authorization: Bearer fsk_...' \
     -H 'Content-Type: application/json' \
     -d '{
       "template_id": "tpl_contrato",
       "document_name": "Contrato — Maria Silva",
       "data": { "contratante": { "nome": "Maria Silva" } }
     }'
   
   HTTP 202
   { "document_id": "doc_abc123", "status": "processando" }
   
   # segundos depois…
   curl https://api.dev.foolscap.app.br/v1/documents/doc_abc123 \
     -H 'Authorization: Bearer fsk_...'
   
   { "status": "gerado", "pages": 2, "pdf_url": "https://…" }