API مجاني للختم الزمني

تتيح واجهة SecureAuthor API لبرنامجك تسجيل الملفات والتحقق منها. أرسل ملفًا بطلب POST لإنشاء إيصال يتضمن بصمة SHA-256 وختمًا زمنيًا بتوقيت UTC، يُسجَّل على بلوكتشين Polygon مرتين يوميًا؛ وأرسل ملفًا مع شهادة أو رقم إيصال بطلب POST للتحقق من تطابقهما. الواجهة مجانية وعلنية وموثّقة في Swagger.

احصل على مفتاح API مجاني

REST API · وثائق Swagger

ما الذي يمكنك بناؤه

  • أنظمة إدارة المحتوى والمدونات: ختم زمني لكل مقال أو صورة عند النشر.
  • أدوات التصميم والتصوير: تسجيل كل ملف مُصدَّر تلقائيًا.
  • سير عمل المستندات: تثبيت النسخة الدقيقة من عقد أو عرض أو فاتورة.
  • مسارات الشيفرة: بصمة لملفات الإصدار في CI.
  • المتاجر الإلكترونية: منح البائعين إثبات تأليف لكل ملف يرفعونه.

احصل على مفتاح

  1. افتح https://run.secureauthor.com وسجّل الدخول بحساب Google.
  2. افتح قسم «مفتاح API» واضغط «إنشاء مفتاح API».
  3. انسخ المفتاح. مرّره في معامل الاستعلام 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 أو رقم الإيصال.

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 (الرمز 0): الملف مطابق للإيصال؛ وfalse (الرمز 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احمِ ملفًا