API de carimbo de tempo grátis

A API do SecureAuthor permite que o seu software registre e verifique arquivos. Envie um arquivo via POST para criar um recibo com o hash SHA-256 e o carimbo de tempo em UTC, registrado na blockchain Polygon duas vezes por dia; envie um arquivo com um certificado ou um ID de recibo para conferir se eles conferem. A API é grátis, pública e documentada no Swagger.

Obter uma chave de API grátis

API REST · documentação Swagger

O que você pode criar

  • CMS e blogs: aplique um carimbo de tempo em cada artigo ou imagem ao publicar.
  • Ferramentas de design e fotografia: registre cada exportação automaticamente.
  • Fluxos de documentos: fixe a versão exata de um contrato, proposta ou fatura.
  • Pipelines de código: gere a impressão digital dos artefatos de release no CI.
  • Marketplaces: dê aos vendedores uma prova de autoria para cada upload.

Obtenha uma chave

  1. Abra https://run.secureauthor.com e entre com o Google.
  2. Abra a seção Chave de API e clique em Gerar chave da API.
  3. Copie a chave. Passe-a no parâmetro de consulta api-key.

Referência completa: documentação da API no Swagger.

Criar um recibo

POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY — multipart/form-data, campo media = o arquivo.

curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
  -F "media=@artwork.png"

Resposta (resumida):

{
  "code": 0,
  "message": "Receipt created successfully",
  "receipt": {
    "id": "cm8ixlzwf0002pj42vqmvev62",
    "hash": "26be856c7aa5748040bcf998b18d3081cacb2ab1e4e3b34aece9e86152f083aa",
    "timeStamp": "2025-03-21T15:25:13.599Z",
    "blockchainLink": null,
    "fileName": "artwork",
    "fileMimeType": "png",
    "fileSize": 26106,
    "nextEntryWritten": "2025-03-22T00:00:00.000Z"
  }
}
  • code: 0 — um novo recibo foi criado.
  • code: 1 — este arquivo já tinha sido registrado; o recibo original é devolvido.
  • blockchainLink fica null até a próxima rodada de registro e depois contém o link do Polygonscan.
  • nextEntryWritten — quando o registro deve entrar na blockchain.

Verificar um arquivo

POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID] — campo media = o arquivo a conferir, campo opcional pdf = o certificado. Passe o PDF do certificado ou o ID do recibo.

curl -X POST "https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY&hash-id=cm8j56xxh0007pj42mj8eg7rl" \
  -F "media=@artwork.png"
{
  "code": 0,
  "fileHash": "a535b2b5…d0",
  "receiptHash": "a535b2b5…d0",
  "receiptId": "cm8j56xxh0007pj42mj8eg7rl",
  "isEqual": true
}

isEqual: true (code 0) — o arquivo confere com o recibo; false (code 1) — não confere.

Erros

RespostaSignificado
{"code": 3, "error": "API key is missing"}Adicione ?api-key= à URL
{"code": 3, "error": "Invalid API key"}Gere uma nova chave no aplicativo web
HTTP 400Nenhum arquivo no campo media ou requisição malformada

Perguntas frequentes

Quanto custa a API?

É grátis. Não há planos pagos nem limites de requisições publicados; o acesso só pode ser suspenso em caso de abuso, como descrito nos Termos de Uso.

Como obtenho uma chave de API?

Entre no aplicativo web com o Google, abra a seção Chave de API e clique em Gerar chave da API. Você pode gerar uma nova a qualquer momento; a chave antiga deixa de funcionar.

Posso enviar só o hash em vez do arquivo?

A API atual recebe o próprio arquivo, calcula o hash SHA-256 no servidor e não armazena o arquivo.

Os recibos da API são iguais aos do site?

Sim. Eles aparecem no histórico da sua conta e podem ser verificados no aplicativo web, na extensão ou pela API.

Atualizado em:

Proteja seu próximo arquivo em segundos

Prova de autoria grátis: hash SHA-256, carimbo de tempo em UTC e registro na blockchain Polygon. Seu arquivo não é armazenado.

Adicionar ao ChromeProteger um arquivo