API للمطورين
واجهة برمجة REST مجانية مع استجابات JSON منظمة. مطلوب مفتاح API (مجاني). CORS مفعّل. مثالي لبناء التطبيقات ومحركات التوصية أو تغذية نماذج LLM ببيانات العطور.
عنوان URL الأساسي
https://fraganty.aiجميع نقاط نهاية API تتطلب مفتاح API مجاني. قم بتضمينه في كل طلب عبر رأس X-API-Key أو معامل api_key.
الرأس
X-API-Key: YOUR_API_KEYمعامل الاستعلام
?api_key=YOUR_API_KEYاطلب مفتاح API المجاني الخاص بك على [email protected]
/api/perfumesقائمة العطور والبحث
المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
| q | string | البحث بالاسم |
| brand | string | فلتر حسب معرّف العلامة التجارية |
| page | number | رقم الصفحة (افتراضي: 1) |
| limit | number | نتائج في الصفحة (افتراضي: 20، الحد الأقصى: 100) |
مثال على الطلب
الاستجابة
{
"data": [
{
"id": "rose-goldea-kathleen-kye-edition",
"name": "Rose Goldea Kathleen Kye Edition",
"brand": "Bvlgari",
"year": 2021,
"rating": 4.62,
"concentration": null,
"image": "https://img.fraganty.ai/perfume/64818.jpg",
"buyUrl": "https://fraganty.ai/goto/rose-goldea-kathleen-kye-edition",
"accords": [
{ "name": "Rose", "strength": 100, "color": "#C4647C" },
{ "name": "Floral", "strength": 79, "color": "#9E3B52" }
]
}
],
"total": 2460,
"page": 1,
"pages": 492
}/api/perfumes/:slugالحصول على تفاصيل العطر الكاملة بما في ذلك المكونات والنغمات والتقييمات والمواسم والعطور المشابهة
مثال على الطلب
الاستجابة
{
"id": "bleu-de-chanel-eau-de-parfum",
"name": "Bleu de Chanel Eau de Parfum",
"brand": "Chanel",
"year": 2014,
"rating": 4.21,
"concentration": "Eau de Parfum",
"gender": "masculine",
"description": "...",
"buyUrl": "https://fraganty.ai/goto/bleu-de-chanel-eau-de-parfum",
"notes": {
"top": [{ "name": "Lemon", "intensity": 80 }],
"middle": [{ "name": "Cedar", "intensity": 90 }],
"base": [{ "name": "Sandalwood", "intensity": 85 }]
},
"accords": [...],
"seasons": { "winter": 45, "spring": 60, "summer": 30, "fall": 65 },
"dayNight": { "day": 55, "night": 70 },
"similarPerfumes": [...],
"perfumers": [{ "name": "Olivier Polge" }]
}/api/brandsقائمة جميع العلامات التجارية مع عدد العطور
المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
| q | string | البحث عن علامات تجارية بالاسم |
مثال على الطلب
الاستجابة
{
"data": [
{ "name": "Guerlain", "slug": "Guerlain", "count": 412 },
{ "name": "Dior", "slug": "Dior", "count": 312 },
{ "name": "Chanel", "slug": "Chanel", "count": 248 }
],
"total": 6619
}/api/notesقائمة جميع المكونات العطرية مع تكرار الظهور
المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
| limit | number | تحديد النتائج (افتراضي: الكل) |
مثال على الطلب
الاستجابة
{
"data": [
{ "name": "Musk", "count": 3097 },
{ "name": "Bergamot", "count": 2498 },
{ "name": "Rose", "count": 2460 }
],
"total": 981
}/api/perfumersقائمة جميع صانعي العطور مع عدد العطور
مثال على الطلب
الاستجابة
{
"data": [
{ "name": "Alberto Morillas", "slug": "alberto-morillas", "count": 45 },
{ "name": "Olivier Polge", "slug": "olivier-polge", "count": 38 }
],
"total": 358
}/api/perfumers/:slugالحصول على تفاصيل صانع العطور مع عطوره (مع ترقيم الصفحات)
المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
| page | number | رقم الصفحة (افتراضي: 1) |
| limit | number | نتائج في الصفحة (افتراضي: 20) |
مثال على الطلب
الاستجابة
{
"name": "Alberto Morillas",
"slug": "alberto-morillas",
"perfumes": {
"data": [...],
"total": 45,
"page": 1,
"pages": 3
}
}