/artworks
تصفّح كتالوج الأعمال العام بعد التحقق من حقوقه.
عام
RELICT API · v1.3.29
بيانات الفن وتحليلاته عبر واجهة API واحدة.
الوصول إلى الكتالوج العام وأدلة السجل وبيانات السوق وفق الحقوق والمبيعات المقارنة ومؤشرات الفنانين الثابتة والتقييم البحثي والتصدير المدقق عبر عقد واجهة واحد ذي إصدارات.
كتالوج عام دون مفتاحوصول Bearer محدد النطاقحقوق على مستوى الحقولوحدات موزونة
بدء سريع
ابدأ بنقطة الحالة العامة، ثم انتقل إلى وصول Bearer بالنطاقات المطلوبة.
1
التحقق من عقد الواجهة
اقرأ الحالة وOpenAPI دون مفتاح.
2
إصدار مفتاح محدد النطاق
أنشئ عميل API داخل مساحة عمل المؤسسة.
3
استدعاء الموارد المصرّح بها
يُحتسب الاستخدام بعد نجاح التحقق من المصادقة والنطاقات فقط.
curl --request GET \
'https://relict.cloud/api/v1/status' \
--header 'Accept: application/json'{
"product": "RELICT API",
"version": "1.3.29",
"status": "operational",
"as_of": "<UTC timestamp>"
}المصادقة
تستخدم مسارات السجل والتحليلات التجارية مفتاح Bearer بنطاقات صريحة.
curl --request GET \
'https://relict.cloud/api/v1/registry/search?q=monet' \
--header 'Authorization: Bearer relict_live_…' \
--header 'Accept: application/json'قواعد الأمان
تُعرض المفاتيح مرة واحدة فقط.
يحتفظ الخادم ببصمات المفاتيح دون نسخ نصية قابلة للاسترجاع. تُرفض الطلبات غير المصرح بها أو خارج النطاق قبل احتساب الوحدات.
نطاقات الوصولالحصصضوابط IPسجلات التدقيق
نقاط النهاية الأساسية
هذه المسارات من عقد `/api/v1` الحالي، دون نقاط نهاية وهمية مثل `/advisor` أو `/valuations`.
/registry/search
ابحث في السجل المرجعي ضمن نطاقات API المصرح بها.
Bearer + النطاق
/registry/artworks/{uuid}/evidence
اطّلع على أدلة المصدر والموثوقية والحقوق لكل حقل.
Bearer + النطاق
/intelligence/artworks/{uuid}/sales
وقائع المبيعات المرصودة المتاحة ضمن صلاحيات العميل.
Bearer + النطاق
/intelligence/artworks/{uuid}/comparables
رتّب المبيعات المقارنة دون اعتبار الدرجة تقييمًا ماليًا.
Bearer + النطاق
/intelligence/artists/{uuid}/index
اطّلع على إصدارات مؤشرات الفنانين الثابتة وأدلتها.
Bearer + النطاق
/intelligence/artworks/{uuid}/valuation/research
شغّل تقييمًا بحثيًا أو تجريبيًا بأدلة واضحة وحالة صريحة عند تعذّر التقييم.
Bearer + النطاق
/exports
أنشئ تصديرًا مدققًا يراعي الحقوق للعملاء المصرح لهم.
Bearer + النطاق
توليد عميل OpenAPI
لا أسماء وهمية لحزم npm أو Python.
OpenAPI 3.1
ولّد عميلًا محدد الأنواع بأدوات بيئتك الموثوقة.
https://relict.cloud/api/v1/openapi.jsonحالة SDK الرسمي
لا تتضمن هذه النسخة حزمة SDK رسمية من RELICT. عقد API هو المرجع المعتمد للتكامل.
contract: v1.3.29خطافات الويب
يُضبط لكل عميل API في المؤسسة.
إرسال HTTP موقّع
إعدادات خاصة بالمؤسسة
إلغاء من مساحة العمل أو لوحة الإدارة
حالة إرسال مدققة
وحدات RELICT
استخدام موزون لنقاط النهاية وفق إعدادات النظام الحالية.
search
1 وحدات API لكل طلب مقبول.
artist.basic
1 وحدات API لكل طلب مقبول.
artwork.basic
1 وحدات API لكل طلب مقبول.
artwork.evidence
2 وحدات API لكل طلب مقبول.
sales.list
3 وحدات API لكل طلب مقبول.
artist.index
4 وحدات API لكل طلب مقبول.
market.analytics
5 وحدات API لكل طلب مقبول.
comparables
8 وحدات API لكل طلب مقبول.
export.create
10 وحدات API لكل طلب مقبول.
export.status
1 وحدات API لكل طلب مقبول.
export.download
1 وحدات API لكل طلب مقبول.
asset.grant
2 وحدات API لكل طلب مقبول.
visual.similarity
10 وحدات API لكل طلب مقبول.
valuation.ai
20 وحدات API لكل طلب مقبول.
لا توسّع API حقوق استخدام بيانات المصدر.
تبقى البيانات العامة والبحثية والتجارية المرخّصة منفصلة وفق سياسة الاستخدام. وتُفصل وقائع المبيعات المرصودة عن التقديرات النموذجية ومؤشرات الفنانين، مع المصدر والتاريخ والموثوقية والمنهجية حيث يتيحها العقد.