API رایگان مهر زمانی

API سرویس SecureAuthor به نرم‌افزار شما امکان می‌دهد فایل‌ها را ثبت و بررسی کند. با ارسال POST یک فایل، رسیدی با هش SHA-256 و مهر زمانی UTC آن ساخته می‌شود که دو بار در روز در بلاکچین Polygon ثبت می‌شود؛ با ارسال POST یک فایل همراه با گواهی یا شناسه رسید، مطابقت آن‌ها بررسی می‌شود. این API رایگان و عمومی است و در Swagger مستند شده است.

دریافت کلید API رایگان

REST API · مستندات Swagger

چه چیزهایی می‌توانید بسازید

  • CMS و وبلاگ‌ها: هنگام انتشار، برای هر مقاله یا تصویر مهر زمانی بگیرید.
  • ابزارهای طراحی و عکس: هر خروجی را به‌طور خودکار ثبت کنید.
  • گردش کار اسناد: نسخه دقیق یک قرارداد، پیشنهاد قیمت یا فاکتور را ثبت کنید.
  • پایپ‌لاین‌های کد: در CI از فایل‌های انتشار اثر انگشت دیجیتال بگیرید.
  • فروشگاه‌های آنلاین چندفروشنده: برای هر بارگذاری به فروشندگان اثبات پدیدآورندگی بدهید.

دریافت کلید

  1. https://run.secureauthor.com را باز کنید و با Google وارد شوید.
  2. بخش «کلید API» را باز کنید و دکمه ساخت کلید API را بزنید.
  3. کلید را کپی کنید. آن را به‌عنوان پارامتر کوئری 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 گواهی را بفرستید یا شناسه رسید را.

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= را به نشانی اضافه کنید
{"code": 3, "error": "Invalid API key"}کلید را در وب‌اپلیکیشن دوباره بسازید
HTTP 400فایلی در فیلد media نیست یا درخواست نادرست است

پرسش‌های متداول

هزینه API چقدر است؟

رایگان است. هیچ طرح پولی و هیچ محدودیت نرخ اعلام‌شده‌ای وجود ندارد؛ دسترسی فقط در صورت سوءاستفاده، طبق شرایط استفاده، ممکن است تعلیق شود.

چگونه کلید API بگیرم؟

با Google وارد وب‌اپلیکیشن شوید، بخش «کلید API» را باز کنید و دکمه ساخت کلید API را بزنید. هر زمان می‌توانید کلید را دوباره بسازید؛ کلید قبلی از کار می‌افتد.

آیا می‌توانم به‌جای فایل فقط هش را بفرستم؟

API فعلی خود فایل را می‌پذیرد، هش SHA-256 را روی سرور محاسبه می‌کند و فایل را ذخیره نمی‌کند.

آیا رسیدهای API با رسیدهای وب یکسان‌اند؟

بله. در سابقه حساب شما نمایش داده می‌شوند و می‌توان آن‌ها را در وب‌اپلیکیشن، افزونه یا از طریق API بررسی کرد.

به‌روزرسانی:

فایل بعدی خود را در چند ثانیه محافظت کنید

اثبات پدیدآورندگی رایگان: هش SHA-256، مهر زمانی UTC و ثبت در بلاکچین Polygon. فایل شما ذخیره نمی‌شود.

افزودن به Chromeمحافظت از فایل