البداية: أول طلب في دقيقتين
أنشئ حساب أعمال، خذ مفتاح اختبار، وتعرّف على أول عطر من صورة عبر واجهة عطرنا البرمجية.
1. أنشئ حساباً
سجّل الدخول بحساب عطرنا، وافتح لوحة التحكم، واكتب اسم شركتك وبلدها. تحصل فوراً على الخطة المجانية (200 رصيد شهرياً) ومفتاح اختبار.
2. انسخ المفتاح
يظهر المفتاح مرة واحدة فقط. مفاتيح os_test_ تعيد بيانات نموذجية ثابتة مجاناً؛ مفاتيح os_live_ تعيد البيانات الحقيقية وتخصم الرصيد.
3. أرسل صورة
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. اقرأ سجل العطر
خذ perfume_id من الإجابة الأولى واطلب سجلّه، أو أضف ?expand=perfume إلى طلب التعرّف ليأتي السجل مع كل احتمال.
curl "https://api.ourscent.online/v1/perfumes/{id}?lang=fr" \
-H "Authorization: Bearer os_live_…"