واجهة PriceLens البرمجية
أسعار وتاريخ وعروض المتاجر التي نتابعها بصيغة JSON، لمساحات Enterprise.
المصادقة
أنشئ مفتاحًا من الأعمال ← API. أرسله كـ bearer token أو في ترويسة X-API-Key.
curl -H "Authorization: Bearer pl_live_..." \ "https://pricelens.store/api/v1/partner/search?q=iphone%2015"
المسارات
| GET | الصلاحية | |
|---|---|---|
| /search?q={text} | market:read | ابحث عن المنتجات بالاسم؛ ويعيد المعرّفات المستخدمة بالأسفل. |
| /products/{id}/market?days=90 | market:read | العروض الحالية لكل متجر، والوسيط، وتاريخ السعر، والتوفر لمنتج واحد. |
| /market/stats?brand={brand} | market:read | إحصاءات الأسعار لعلامة تجارية أو فئة. |
| /events?type={type}&since={date} | events:read | أحداث المنافسين الخاصة بمساحتك (انخفاضات الأسعار، والتسعير الأقل، ومخالفات MAP). |
| /whoami | — | يؤكد صلاحية المفتاح ويعرض صلاحياته وحده اليومي. |
Base URL: https://pricelens.store/api/v1/partner
الحدود
لكل مفتاح حد يومي للطلبات تحدده الباقة. كل رد يحمل X-RateLimit-Limit وX-RateLimit-Remaining؛ وبعد الحد يرد API بـ 429 حتى 00:00 بتوقيت UTC.
قواعد عامة
الردود بصيغة snake_case. الحقل null يعني أنه لا توجد لدينا ملاحظة، وليس صفرًا. الأسعار بعملة EGP. المعرّفات: استخدم id أو slug من البحث، أو GTIN أو EAN أو UPC أو MPN.