الواجهة البرمجية العامة
واجهة برمجية JSON للقراءة فقط، تُخدَم من قاعدة بياناتنا. نرجو الاعتدال: 20 طلبًا في الثانية كحد أقصى، مع تخزين الاستجابات مؤقتًا.
| نقطة الوصول | الوصف |
|---|---|
GET /proxy/v2/search?q=… | Recherche plein texte. Paramètres : q, prefix=1 (saisie partielle), page (≤ 200), page_size (≤ 100), sort_by (unique_scans_n, last_modified_t, product_name), fields. Un code-barres dans q renvoie directement le produit (barcode_match). |
… &is_halal=1 / &is_excluded=1 | Produits au statut halal / haram (aussi : &halal_status=doubtful). |
… &labels_tags=en:organic | Filtres par tag exact : labels_tags, categories_tags, countries_tags (répétables). |
GET /proxy/v2/product/{code}.json | Fiche complète, dont halal_status et halal (raisons détaillées). |
GET /proxy/stats | Chiffres clés. Répond 503 + Retry-After pendant le calcul. |
GET /proxy/facets/{type}.json | countries, labels, categories, contributors. |
GET /proxy/top · /proxy/recent | Produits les plus consultés / modifiés récemment (page_size ≤ 50). |
Statut halal (halal_status)
halal- ملصق حلال مُعلَن، أو مكوّنات مذكورة خالية من الكحول والخنزير.
haram- كحول أو خنزير في المكوّنات، أو ملصق كحول / غير حلال مُعلَن.
doubtful- ملصقات متناقضة، أو مكوّن غير مؤكد المصدر (جيلاتين، E120، E471، منفحة…) دون ملصق حلال.
unknown- قائمة المكوّنات غير موجودة.
هذه الحالات ليست شهادات. البيانات بموجب ترخيص ODbL : اذكر Halal Open Beauty Facts و Open Beauty Facts.
مثال
curl "https://halalopenbeautyfacts.org/proxy/v2/search?q=couscous&is_halal=1&page_size=5&fields=code,product_name,halal_status"