Бесплатный 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-ключ» и нажмите «Сгенерировать API ключ».
  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 ключ». Ключ можно перевыпустить в любой момент; старый ключ перестанет работать.

Можно ли отправить только хеш вместо файла?

Текущий API принимает сам файл, вычисляет хеш SHA-256 на сервере и не хранит файл.

Квитанции из API такие же, как в веб-приложении?

Да. Они появляются в истории вашего аккаунта и проверяются в веб-приложении, в расширении или через API.

Обновлено:

Защитите свой следующий файл за секунды

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

Установить в ChromeЗащитить файл