Démarrer : votre premier appel en deux minutes
Créez un compte professionnel, prenez une clé de test et identifiez votre premier parfum par photo avec l’API OurScent.
1. Créez un compte
Connectez-vous avec votre compte OurScent, ouvrez la console et saisissez votre société et votre pays. Vous recevez aussitôt l’offre gratuite (200 crédits par mois) et une clé de test.
2. Copiez votre clé
La clé n’est affichée qu’une fois. Les clés os_test_ renvoient gratuitement des données d’exemple fixes ; les clés os_live_ renvoient les vraies données et consomment des crédits.
3. Envoyez une photo
curl -X POST "https://api.ourscent.online/v1/vision/identify?k=5" \
-H "Authorization: Bearer os_live_…" \
-H "Content-Type: image/jpeg" \
--data-binary @bottle.jpgJSON
{
"model": "c-20261122",
"candidates": [
{
"perfume_id": "Khamrah-Lattafa-Perfumes-Lattafa-Perfumes",
"score": 0.91,
"name": "Khamrah",
"name_ar": "خمرة",
"brand": { "id": "lattafa", "name": "Lattafa", "name_ar": "لطافة" },
"thumbnail_url": "https://ourscent.online/perfume-images/…/w400.webp"
},
{ "perfume_id": "Khamrah-Qahwa-Lattafa-Perfumes-Lattafa-Perfumes", "score": 0.06, "…": "…" }
],
"request_id": "req_8f2c…"
}4. Lisez la fiche du parfum
Prenez le perfume_id du premier candidat et demandez sa fiche, ou ajoutez ?expand=perfume à l’appel d’identification pour recevoir la fiche avec chaque candidat.
curl "https://api.ourscent.online/v1/perfumes/{id}?lang=fr" \
-H "Authorization: Bearer os_live_…"