API Προγραμματιστών
Δωρεάν REST API με δομημένες JSON απαντήσεις. Απαιτείται κλειδί API (δωρεάν). CORS ενεργοποιημένο. Ιδανικό για εφαρμογές, μηχανές σύστασης ή τροφοδοσία LLMs με δεδομένα αρωμάτων.
Βασικό URL
https://fraganty.aiΌλα τα API endpoints απαιτούν ένα δωρεάν κλειδί 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 | Φίλτρο κατά slug οίκου |
| 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
}
}