FIRMATO ORIGINAL · MOCK API v1
اربط أرشيفك الإبداعي
اختبر واجهات Firmato بأعمال اصطناعية وأرصدة افتراضية، دون ملفات أصلية أو خصم فعلي أو نشر عام.
البدء
افتح بوابة الشركاء وأكمل التحقق المطلوب وأنشئ مشروع MOCK. اطلب صراحة الصلاحيتين original:read وoriginal:write. لا تحصل الرموز الحالية على صلاحيات جديدة تلقائياً.
Authorization: Bearer <FIRMATO_MOCK_TOKEN>
Content-Type: application/json · Idempotency-Key: TEST-ORIGINAL-0001
العمليات المتاحة
| الطريقة | المورد | العملية |
|---|---|---|
| GET | /v1/original-works | عرض الأعمال الاصطناعية للمشروع |
| POST | /v1/original-works | إنشاء عمل اصطناعي |
| GET | /v1/original-works/{id} | قراءة عمل اصطناعي |
| POST | /v1/original-works/{id}/compare | محاكاة مقارنة نسخة |
| POST | /v1/original-works/{id}/cost-preview | محاكاة ملخص تكلفة |
https://firmato.org/api/v1/partners/index.php?route=%2Fmock%2Fv1%2Foriginal-works
external_reference: TEST-example · media_kind: image | audio | video | other
candidate_fixture: same | different
service_code: deposit | timestamp | storage | licence
مثال PHP
$client = new \Firmato\Sdk\Client(getenv('FIRMATO_MOCK_TOKEN'));
$work = $client->createOriginal('TEST-example', 'image', 'TEST-ORIGINAL-0001');
$id = $work['data']['id'];
$comparison = $client->compareOriginal($id, 'same', 'TEST-COMPARE-0001');
$preview = $client->previewOriginalCost($id, 'timestamp', 'TEST-PREVIEW-0001');قواعد Sandbox
استخدم مراجع تبدأ بـ TEST- ومفتاح Idempotency-Key ثابتاً لكل طلب POST. لا ترسل ملفات أو بيانات شخصية. استخدام المفتاح نفسه لطلب مختلف يعيد HTTP 409.
الموارد معزولة حسب المشروع. نتائج MOCK ليست توقيعات أو أختاماً زمنية أو شهادات ملكية أو أدلة نشر. الأرصدة الافتراضية ليست أسعاراً حقيقية.
موارد Original متاحة في MOCK فقط، وLIVE معطل. لم تكتمل اختبارات CMS والاختبارات الموثقة الكاملة للمسار الجديد.