REST API · документация в Swagger
Какво можете да създадете
- CMS и блогове: времеви печат на всяка статия или изображение при публикуване.
- Инструменти за дизайн и снимки: автоматична регистрация на всеки експорт.
- Документооборот: фиксиране на точната версия на договор, оферта или фактура.
- Процеси за код: отпечатък на артефактите на всяка версия в CI.
- Онлайн платформи за продажба: доказателство за авторство за всяко качване на продавачите.
Вземете ключ
- Отворете https://run.secureauthor.com и влезте с Google.
- Отворете раздела „API ключ“ и натиснете бутона за генериране на ключ.
- Копирайте ключа. Подавайте го като параметър на заявката
api-key.
Пълно описание: API документация в 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 или заявката е неправилна |