API VALIDOC

Integre envio, assinatura e validação em minutos.

Exemplos prontos para Delphi, Python, Java, JavaScript, PHP e C#. O foco principal é facilitar a vida de quem trabalha com Delphi, Firebird e sistemas legados.

Baixar unit Delphi .pas Ver exemplo Delphi

Base URL https://api.validoc.app.br/v1 Autenticação X-API-Key: SUA_CHAVE Formato application/json

Enviar documento

POST /documentos/enviar

Envia PDF por WhatsApp, e-mail ou ambos.

Reenviar link

POST /documentos/{id}/reenviar

Reenvia o link e o código para o destinatário.

Consultar status

GET /documentos/{id}/status

Retorna enviado, visualizado, assinado, rejeitado ou expirado.

Validação pública

GET /documentos/{token}/validar

Usado pelo QR Code ou link público de validação.

Delphi primeiro

Unit pronta para copiar ou baixar.

Exemplo compatível com Delphi 12 usando THTTPClient. Pode ser adaptado para FireDAC e rotinas do seu ERP.

uses ValidocAPI;

var
  LApi: TValidocAPI;
  LResp: string;
begin
  LApi := TValidocAPI.Create('https://api.validoc.app.br/v1', 'SUA_CHAVE_API');
  try
    LResp := LApi.EnviarDocumentoPDF(
      'Contrato de prestação.pdf',
      'Cliente Teste',
      '5585997393939',
      'cliente@email.com',
      'CONTRATO',
      'ArquivoBase64Aqui'
    );
  finally
    LApi.Free;
  end;
end;

ValidocAPI.pas Python Java JavaScript PHP C#

Payload

Exemplo de envio.

{
  "cliente_nome": "Construtora Exemplo",
  "documento_nome": "Contrato de prestação.pdf",
  "arquivo_base64": "JVBERi0xLjQ...",
  "canais": ["WHATSAPP", "EMAIL"],
  "whatsapp": "5585997393939",
  "email": "cliente@email.com",
  "exigir_otp": true,
  "webhook_url": "https://seusistema.com.br/webhook/validoc"
}

Webhooks

Seu sistema recebe cada mudança de status.

Status enviados

DOCUMENTO_ENVIADO
LINK_ABERTO
OTP_VALIDADO
DOCUMENTO_ASSINADO
DOCUMENTO_REJEITADO
DOCUMENTO_EXPIRADO

Segurança

Assinatura HMAC no header
IP, user-agent e data/hora
Hash do documento
Log de tentativas e reenvios