REST API · Swagger dokümantasyonu
Neler geliştirebilirsiniz
- CMS ve bloglar: her makaleye veya görsele yayın anında zaman damgası vurun.
- Tasarım ve fotoğraf araçları: her dışa aktarmayı otomatik olarak kaydedin.
- Belge iş akışları: bir sözleşmenin, teklifin veya faturanın tam sürümünü sabitleyin.
- Kod hatları: CI’da sürüm çıktılarının parmak izini alın.
- Pazaryerleri: satıcılara her yükleme için eser sahipliği kanıtı sunun.
Anahtar alın
- https://run.secureauthor.com adresini açın ve Google ile oturum açın.
- API anahtarı bölümünü açın ve anahtar oluşturma düğmesine (Generate API key) basın.
- Anahtarı kopyalayın. Onu
api-keysorgu parametresi olarak gönderin.
Tam başvuru kaynağı: Swagger dokümantasyonu.
Makbuz oluşturma
POST https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY
— multipart/form-data, media alanı = dosya.
curl -X POST "https://api.secureauthor.com/api/recipient/user-api/create-with-pdf?api-key=YOUR_KEY" \
-F "media=@artwork.png"
Yanıt (kısaltılmış):
{
"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— yeni makbuz oluşturuldu.code: 1— bu dosya daha önce kaydedilmiş; orijinal makbuz döndürülür.blockchainLink, bir sonraki kayıt çalıştırmasına kadarnullolur, ardından Polygonscan bağlantısını içerir.nextEntryWritten— kaydın zincirde görünmesinin beklendiği zaman.
Dosya doğrulama
POST https://api.secureauthor.com/api/recipient/user-api/compare-with-pdf?api-key=YOUR_KEY[&hash-id=RECEIPT_ID]
— media alanı = kontrol edilecek dosya, isteğe bağlı pdf alanı = sertifika.
Sertifika PDF’ini ya da makbuz kimliğini gönderin.
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) — dosya makbuzla eşleşiyor; false (code 1) — eşleşmiyor.
Hatalar
| Yanıt | Anlamı |
|---|---|
{"code": 3, "error": "API key is missing"} | URL’ye ?api-key= ekleyin |
{"code": 3, "error": "Invalid API key"} | Anahtarı web uygulamasında yeniden oluşturun |
| HTTP 400 | media alanında dosya yok veya istek hatalı |