REST API · документація Swagger
Що можна створити
- CMS і блоги: мітка часу для кожної статті чи зображення під час публікації.
- Інструменти для дизайну й фото: автоматична реєстрація кожного експорту.
- Документообіг: фіксація точної версії договору, комерційної пропозиції чи рахунку.
- Пайплайни коду: відбитки артефактів релізу в CI.
- Маркетплейси: доказ авторства для продавців до кожного завантаження.
Отримайте ключ
- Відкрийте https://run.secureauthor.com і увійдіть через Google.
- Відкрийте розділ «API-ключ» і натисніть кнопку створення ключа (Generate API key).
- Скопіюйте ключ. Передавайте його в параметрі запиту
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 немає файлу або запит сформовано неправильно |