Безкоштовний API для міток часу

API SecureAuthor дає змогу вашій програмі реєструвати й перевіряти файли. Надішліть файл POST-запитом, щоб створити квитанцію з його хешем SHA-256 і міткою часу UTC, яку двічі на день записують у блокчейн Polygon; надішліть файл із сертифікатом або ID квитанції, щоб перевірити збіг. API безкоштовний, відкритий і описаний у Swagger.

Отримати безкоштовний API-ключ

REST API · документація Swagger

Що можна створити

  • CMS і блоги: мітка часу для кожної статті чи зображення під час публікації.
  • Інструменти для дизайну й фото: автоматична реєстрація кожного експорту.
  • Документообіг: фіксація точної версії договору, комерційної пропозиції чи рахунку.
  • Пайплайни коду: відбитки артефактів релізу в CI.
  • Маркетплейси: доказ авторства для продавців до кожного завантаження.

Отримайте ключ

  1. Відкрийте https://run.secureauthor.com і увійдіть через Google.
  2. Відкрийте розділ «API-ключ» і натисніть кнопку створення ключа (Generate API key).
  3. Скопіюйте ключ. Передавайте його в параметрі запиту api-key.

Повний довідник: документація Swagger.

Створення квитанції

POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY — multipart/form-data, поле media = файл.

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

Відповідь (скорочено):

{
  "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 — створено нову квитанцію.
  • code: 1 — цей файл уже реєстрували; повертається початкова квитанція.
  • blockchainLink дорівнює null до найближчого запису в блокчейн, потім містить посилання на Polygonscan.
  • nextEntryWritten — коли очікується запис у блокчейні.

Перевірка файлу

POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID] — поле media = файл для перевірки, необов'язкове поле pdf = сертифікат. Передайте або PDF-сертифікат, або ID квитанції.

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) — файл відповідає квитанції; false (code 1) — не відповідає.

Помилки

ВідповідьЗначення
{"code": 3, "error": "API key is missing"}Додайте ?api-key= до URL
{"code": 3, "error": "Invalid API key"}Згенеруйте ключ заново у веб-застосунку
HTTP 400У полі media немає файлу або запит сформовано неправильно

Часті запитання

Скільки коштує API?

Він безкоштовний. Платних тарифів і опублікованих обмежень на кількість запитів немає; доступ можуть призупинити лише в разі зловживань, як описано в Умовах використання.

Як отримати API-ключ?

Увійдіть у веб-застосунок через Google, відкрийте розділ «API-ключ» і натисніть кнопку створення ключа. Ключ можна будь-коли згенерувати заново; старий тоді перестане працювати.

Чи можна надіслати лише хеш замість файлу?

Поточний API приймає сам файл, обчислює хеш SHA-256 на сервері й не зберігає файл.

Квитанції з API такі самі, як у вебі?

Так. Вони з'являються в історії вашого акаунта, і їх можна перевірити у веб-застосунку, розширенні або через API.

Оновлено:

Захистіть свій наступний файл за кілька секунд

Безкоштовний доказ авторства: хеш SHA-256, мітка часу UTC і запис у блокчейні Polygon. Ваш файл не зберігається.

Додати в ChromeЗахистити файл