API & INTEGRAÇÕES

Construa no Ecossistema IBEDIS Token

Integre registro na blockchain, assinaturas digitais ICP-Brasil e blindagem forense de PDFs diretamente no seu sistema ou site com validade jurídica instantânea.

VER EXEMPLOS DE CÓDIGO

Regras de Acesso e Segurança

Para realizar requisições e integrar nossos serviços, as seguintes políticas de segurança são aplicadas estritamente em produção:

Conta & Chave de API

Toda requisição deve conter o cabeçalho x-api-key. É necessário ter uma conta ativa no Portal IBEDIS Token para gerar e gerenciar suas chaves de acesso.

Domínio Autorizado

Por motivos de segurança, as chamadas à API são restritas por origem. Você deve cadastrar o domínio do seu servidor/site (whitelist) nas configurações de chave no portal para autorizar as requisições.

Carteira de Créditos

A plataforma opera sob um modelo Pay-as-you-go (de acordo com o uso). Cada chamada de API bem-sucedida consome créditos unificados da sua carteira. Se a carteira zerar, as chamadas retornam status 402.

Endpoints e Tabela de Créditos

Os créditos podem ser comprados no portal corporativo. 1 Crédito equivale a R$ 1,00.

EndpointServiçoDescriçãoCusto por Uso
POST/api/integration/registerRegistro de Documento (ShieldDoc)Registra o hash SHA-256 e armazena um arquivo de forma descentralizada no IPFS, gerando um certificado público.14 créditos
POST/api/integration/signatureAssinatura Digital (ICP & Eletrônica)Cria um envelope eletrônico com múltiplos signatários e envia links de assinatura e códigos OTP por e-mail.9 créditos
POST/api/integration/shieldBlindagem Forense (ShieldPDF)Bloqueia cópias, impressões e edições de arquivos PDF aplicando marcas d'água dinâmicas e rastreamento de acessos.29 créditos

Exemplos de Código Práticos

Integre facilmente em poucas linhas de código. Nosso payload recebe multipart/form-data com o binário original e os metadados do documento. O retorno inclui o identificador único da blockchain e a URL pública para download do certificado com validade jurídica nacional.

Suporte a múltiplos assinantes por envelope
Compatível com a arquitetura PAdES da ICP-Brasil
Registros descentralizados via IPFS Pinata
# 1. Registrar um Documento na Blockchain
curl -X POST "https://token.ibedis.com.br/api/integration/register" \
  -H "x-api-key: SUA_CHAVE_DE_API" \
  -F "file=@contrato.pdf" \
  -F "titulo=Contrato de Prestação de Serviços" \
  -F "nome=João Silva" \
  -F "email=joao@cliente.com" \
  -F "hash=SHA256_DO_ARQUIVO" \
  -F "categoria=contrato"

# 2. Assinar PDF Programaticamente (Certificado A1 do Cofre)
curl -X POST "https://token.ibedis.com.br/api/integration/v1/documents/sign" \
  -H "x-api-key: SUA_CHAVE_DE_API" \
  -F "file=@contrato.pdf" \
  -F "password=SENHA_DO_SEU_CERTIFICADO" \
  -F "role=Testemunha" \
  --output contrato_assinado.pdf
PROPOSTA DE PLUGIN

Plugin WordPress Completo: White-Label Shield

Estamos projetando um plugin completo para WordPress que habilita a funcionalidade de Assinatura Digital e Blindagem de Documentos (White-Label Shield) diretamente nos sites dos clientes, protegendo a distribuição de arquivos (e-books, contratos, ingressos, laudos) com autenticação baseada em API.

Shortcode de Upload Direto

Embede um widget de upload para seus clientes registrarem contratos na blockchain.

Autenticação Segura via API

Conexão direta usando sua API Key configurada nas opções do WordPress, com validação de domínio.

WooCommerce Integration

Blinde automaticamente downloads de e-books e PDFs comprados na sua loja WooCommerce.

Painel de Saldo de Créditos

Veja seus créditos em tempo real diretamente da administração do WordPress.