للمطورين
سجل مفتوح لأي مصرف أو محفظة أو شركة تقنية مالية أو تطبيق: ملف JSON واحد يصف كل الشركات، وشعاراتها على شبكة توزيع. مجاني، بلا مفتاح ولا تسجيل. تديره نبتون، وليس حكراً على تطبيقاتها.
البداية السريعة
- الفهرس
https://logos-cdn.neptune.ly/v1/index.json- الشعار
https://logos-cdn.neptune.ly/v1/logo/{logo}-{96|256}.webp- المخطط
- JSON Schema للفهرس
curl -s https://logos-cdn.neptune.ly/v1/index.json
const base = 'https://logos-cdn.neptune.ly/v1/';
const idx = await (await fetch(base + 'index.json')).json();
const m = idx.merchants.find((m) => m.id === 'amazon');
const logo = base + idx.logoPath
.replace('{logo}', m.logo).replace('{size}', 96);
شكل الفهرس
كل شركة: id ثابت، وnames (العربي أولاً)، وaliases (أسماء بديلة وصيغ كشوف البطاقات مثل AMZN Mktp)، وtags، وcategory، وaccounts بصيغة bank:15-digit، وmerchantIds بصيغة network:id، وlogo بصمة الصورة. التعريف الكامل في المخطط.
التخزين والتحديث
- اطلب الفهرس مرة في اليوم على الأكثر، مع
If-None-Match؛ يصلك304إن لم يتغير. الشبكة تخزّنه دقائق وتعيد التحقق. - ملفات الشعارات تُسمّى ببصمة محتواها فلا تتغير أبداً (
immutable)؛ خزّنها بلا انتهاء. - الفهرس والشعارات تُرسل
Access-Control-Allow-Origin: *، فتعمل من أي موقع أو تطبيق. - شركة مسحوبة تختفي من الفهرس التالي؛ احذف ما خزّنته منها عند التحديث.
مطابقة المعاملة بالشركة
- الحساب أولاً. الآيبان الليبي أو رقم الحساب مع رمز المصرف. تطابق الحساب يحسم.
- ثم الاسم بعد توحيده. أحرف صغيرة، والهمزات والياء والتاء المربوطة حرف واحد، وP=B وV=F، وتُحذف كلمات مثل «شركة» وLtd وأل التعريف.
- الأخطاء الإملائية بوزنها. حرف علة زائد أو ناقص أو مُبدَل (Libyna، Libiana، برستو) يُغتفر من 5 أحرف؛ تغيير حرف ساكن يصنع كلمة أخرى (Almadar / Almadak) فلا يُغتفر إلا في الأسماء الطويلة.
- المطابقة التقريبية تشرح الاسم كله. لا تُقبل إلا إذا غطّت 80% من حروف الاسم، دون اسم المدينة أو الدولة: «BARDEM AL MADAK» محل آخر.
- نوع المكان يجب أن يتفق. اسم يقول «مقهى» أو «صيدلية» أو «فندق» لا يأخذ شعار شركة من نشاط آخر.
- الشك يعني لا شعار. إن تقارب تاجران لا يُعرض أي منهما. شعار خاطئ أسوأ من لا شعار.
المواصفة الكاملة للمطابقة، وهي ما تتبعه تطبيقاتنا وحالات الاختبار المشتركة.
الثبات والإصدارات
- داخل
schema: 1التغييرات إضافية فقط: قد تظهر حقول اختيارية جديدة أو أنشطة جديدة، ولا يتغير معنى حقل موجود. تجاهل ما لا تعرفه. - أي تغيير يكسر التوافق يصدر
schema: 2على مسار/v2/، ويبقى/v1/يعمل. - روابط الشعارات المنشورة لا تتغير، و
idالشركة لا يُعاد استخدامه.
شروط الاستخدام
- مجاني لأي استخدام تجاري أو غير تجاري، بلا مفتاح.
- الشعارات علامات أصحابها؛ اعرضها فقط للتعريف بالشركة في معاملة أو قائمة، لا في إعلان ولا بما يوحي بشراكة أو تأييد.
- نسحب أي شعار يطلب صاحبه سحبه، فحدّث نسختك يومياً.
- ذكر المصدر («شعارات من سجل نبتون») محل تقدير، وليس شرطاً.
- الخدمة كما هي، دون ضمان. لا تستخدمها في ما يخالف القانون أو لانتحال شخصية شركة.
عرّف تطبيقك
أرسل في كل طلب ترويسة User-Agent تسمّي تطبيقك، كما تطلب سياسات OpenStreetMap وويكيميديا:
User-Agent: YourApp/1.0 (com.your.app; dev@your.app)
بها نعرف من يعتمد على السجل فنراسله قبل أي تغيير. نعدّ مجاميع يومية فقط لكل تطبيق ودولة، دون عناوين IP ولا أي بيانات عن الأشخاص. الطلب بلا تعريف يعمل كالمعتاد.
الخصوصية
طابِق على جهاز المستخدم. لا ترسل كشف حسابه أو معاملاته إلى أي خادم، ولا إلينا: الفهرس كامل عندك، ولا نحتاج أن نعرف ما يشتريه أحد.
التواصل والحالة
أسئلة الربط، أو خطأ في شركة، أو طلب سحب: logos@neptune.ly.
آخر نشر للفهرس: 2026-11-18 20:02 UTC. حقل version في الفهرس هو نفسه، فاستعمله لتعرف إن كانت نسختك حديثة.