REST API · dokumentacja Swagger
Co możesz zbudować
- CMS-y i blogi: znacznik czasu dla każdego artykułu lub obrazu przy publikacji.
- Narzędzia do projektowania i zdjęć: automatyczna rejestracja każdego eksportu.
- Obieg dokumentów: utrwalenie dokładnej wersji umowy, oferty lub faktury.
- Pipeline'y kodu: odciski artefaktów wydań w CI.
- Marketplace'y: dowód autorstwa dla sprzedawców przy każdym przesłanym pliku.
Zdobądź klucz
- Otwórz https://run.secureauthor.com i zaloguj się przez Google.
- Otwórz sekcję Klucz API i wygeneruj klucz.
- Skopiuj klucz. Przekazuj go jako parametr zapytania
api-key.
Pełna dokumentacja: Dokumentacja API w Swagger.
Utwórz potwierdzenie
POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY
— multipart/form-data, pole media = plik.
curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
-F "media=@artwork.png"
Odpowiedź (skrócona):
{
"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— utworzono nowe potwierdzenie.code: 1— ten plik był już zarejestrowany; zwracane jest pierwotne potwierdzenie.blockchainLinkma wartośćnulldo najbliższego zapisu, potem zawiera link do Polygonscan.nextEntryWritten— kiedy zapis ma się pojawić w blockchainie.
Zweryfikuj plik
POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID]
— pole media = plik do sprawdzenia, opcjonalne pole pdf = certyfikat.
Przekaż albo certyfikat PDF, albo ID potwierdzenia.
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) — plik zgadza się z potwierdzeniem; false (code 1) — nie zgadza się.
Błędy
| Odpowiedź | Znaczenie |
|---|---|
{"code": 3, "error": "API key is missing"} | Dodaj ?api-key= do adresu URL |
{"code": 3, "error": "Invalid API key"} | Wygeneruj klucz ponownie w aplikacji webowej |
| HTTP 400 | Brak pliku w polu media lub błędne zapytanie |