الانتقال إلى المحتوى الرئيسي
POST
تحميل نسخة مستند خاص
استخدم جلسة حامل مساحة عمل صالحة. لا يمكن لمفتاح واجهة برمجة التطبيقات تخويل نقطة النهاية هذه. يتم اشتقاق مساحة العمل والبيئة الحالية من تلك الجلسة. راجع معالجة المعلومات لقيود الملفات، وإدارة الإصدارات، والاحتجاز، والاحتفاظ، وسلوك التخلص.

التفويضات

Authorization
string
header
مطلوب

JWT للعمليات التي يبدأها المستخدم

الترويسات

Idempotency-Key
string<uuid>
مطلوب

معرف UUID واحد لكل تحميل مقصود. أعد استخدامه مع نفس الملف لإعادة المحاولات؛ لا تعيد استخدامه لملفات مختلفة.

الجسم

multipart/form-data
file
file
مطلوب

ملف PDF أو UTF-8 .txt، .md، .json، .yaml، .yml، من 1 بايت إلى 5 ميغابايت.

document_id
string<uuid>

احذف لمستند جديد. قم بتوفير معرف مستند نشط لإلحاق إصدار جديد.

title
string

مطلوب لمستند جديد.

Maximum string length: 160
category
enum<string>

مطلوب لمستند جديد.

الخيارات المتاحة:
technical_specification,
architecture,
security,
policy,
general
description
string
Maximum string length: 2000

الاستجابة

استجابة ناجحة

id
string<uuid>
document_id
string<uuid>
version
integer
filename
string
content_type
string
size_bytes
integer
sha256
string
Pattern: ^[a-f0-9]{64}$
created_at
string<date-time>
purged_at
string<date-time> | null