سؤال

# واجهة سلة البرمجية أم قاعدة بيانات المتاجر؟

الأولى تعمل داخل المتاجر التي تثبّت تطبيقك، والثانية تخبرك بالمتاجر الموجودة أصلًا. ومن السهل الخلط بينهما.

آخر تحديث
24 أكتوبر 2026

واجهة سلة البرمجية تمنح التطبيق الوصول إلى بيانات المتاجر التي ثبّتته ومنحته الصلاحية فقط، ولا
تعطيك قائمة بكل متاجر سلة. توثّق سلة (Salla)، منصّة التجارة الإلكترونية السعودية، واجهة التاجر
البرمجية (Merchant API) على [docs.salla.dev](https://docs.salla.dev/): كل طلب يُرسل
نيابةً عن تاجر وافق على تطبيقك عبر OAuth 2.0، وفي حدود الصلاحيات التي منحها هذا التاجر.

أمّا قاعدة بيانات المتاجر فتجيب عن سؤال آخر: ما متاجر سلة الموجودة، وأيّها يطابق شريحة معيّنة. وحتى
أكتوبر 2026 تضم SallaData 41,038 متجرًا موثّقًا على سلة، بما فيها المتاجر التي لم تسمع بتطبيقك قط.
والمطوّر يحتاج غالبًا الأولى لمنتجه والثانية للعثور على عملائه.

## ما هي واجهة التاجر البرمجية في سلة؟

واجهة التاجر مجموعة نقاط REST تحت العنوان الأساسي https://api.salla.dev/admin/v2 ، للعمل على
بيانات متجر واحد: الطلبات والمنتجات والعملاء والتسويق وإعدادات المتجر والشحنات وغيرها. وهي الطريقة التي تقرأ
بها تطبيقات سلة البيانات وتعدّلها داخل المتاجر التي تستخدمها. وتُسجَّل التطبيقات عبر بوابة
[شركاء سلة](https://partners.salla.com/)، حيث يحدّد المطوّر الصلاحيات التي يحتاجها
التطبيق.

## كيف يحصل التطبيق على صلاحية الوصول إلى متجر؟

بحسب [توثيق التفويض](https://docs.salla.dev/doc-421118) في سلة، تجري العملية
هكذا:

- يثبّت التاجر التطبيق ويوافق على الصلاحيات التي يطلبها — مثل orders.read_write أو products.read_write أو customers.read_write .

- في الوضع السهل (Easy Mode) ترسل سلة إلى التطبيق حدث app.store.authorize ومعه رمز الوصول. ويذكر التوثيق أن الوضع السهل هو الوحيد المسموح به للتطبيقات المنشورة في متجر تطبيقات سلة، أما الوضع المخصّص (Custom Mode) فيعتمد على رابط إعادة توجيه.

- رمز الوصول صالح 14 يومًا ويمكن تجديده (صلاحية offline_access تطلب رمز تجديد).

- وبحسب التوثيق، لا يصل التطبيق إلا إلى الموارد التي صادق عليها التاجر.

كما ترسل سلة [أحداث التطبيق](https://docs.salla.dev/doc-421413) مثل
app.installed و app.uninstalled و app.subscription.started — وكلها عن
متاجر تعاملت مع تطبيقك.

## هل تستطيع واجهة سلة البرمجية سرد كل متاجر سلة؟

ليس بحسب توثيقها. لم نجد في توثيق واجهة التاجر نقطة تسرد المتاجر على مستوى المنصّة، ونموذج التفويض نفسه
يمنع ذلك من حيث التصميم: دون موافقة التاجر لا يملك تطبيقك رمز وصول لمتجره. فإن كان لتطبيقك 300 تثبيت، فالواجهة
تخبرك عن 300 متجر.

وهذا أكبر مصدر للخلط حين يبحث أحدهم عن «قاعدة بيانات متاجر سلة» فيصل إلى توثيق الواجهة
البرمجية. فالواجهة باب إلى كل متجر يسمح لك بالدخول، لا دليل بسكّان المبنى.

## ماذا تعطيك قاعدة بيانات متاجر سلة؟

تسجّل قاعدة بيانات المتاجر الحقول العامة نفسها لكل متجر تحقّقت منه، سواء استخدم أي تطبيق أم لا. وفي
SallaData تشمل هذه الحقول: اسم المتجر، والموقع ورابط سلة، وتاريخ الإنشاء، والفئة (واحدة من 21
فئة)، وأقسام المتجر كما يسمّيها، والجوال وواتساب والبريد الإلكتروني، وإنستغرام وتيك توك وسناب شات وإكس،
ومزوّدي التقسيط، وأرقام السجل التجاري ووثيقة العمل الحر والرقم الضريبي حين ينشرها المتجر، إضافةً إلى حالة
المتجر وتاريخ آخر تحقّق. ويحمل كل صف معرّف المتجر في سلة ( store_id )، لتسهيل إزالة التكرار وربط
التحديثات اللاحقة.

وما لا تتضمّنه هو أي بيانات خاصة: لا طلبات ولا إيرادات ولا عملاء ولا زيارات. فهذه تقع خلف الواجهة البرمجية،
ولا تُتاح إلا بإذن التاجر.

## من يحتاج أيّهما؟

| تريد أن… | استخدم |
| --- | --- |
| تزامن الطلبات أو المنتجات أو العملاء للتجار الذين ثبّتوا تطبيقك | واجهة سلة البرمجية |
| تتفاعل حين يثبّت التاجر تطبيقك أو يلغي تثبيته أو يشترك | أحداث التطبيق (Webhooks) |
| تعرف كم متجر جمال أو عطور يوجد على سلة | قاعدة بيانات المتاجر |
| تبني قائمة تواصل بمتاجر لا تستخدم تطبيقك بعد | قاعدة بيانات المتاجر |
| تجد متاجر تقدّم تمارا أو تابي، أو تنشر رقم سجل تجاري | قاعدة بيانات المتاجر |
| تقرأ مبيعات متجر أو سجل طلباته | واجهة سلة البرمجية، بتفويض من التاجر نفسه |

## كيف يتكامل الاثنان؟

التسلسل المعتاد لمطوّر التطبيقات: استخدم قاعدة بيانات المتاجر لتقدير حجم السوق وإيجاد التجار المناسبين
لتطبيقك، وتواصل معهم عبر قنواتهم التجارية المنشورة، وحين يثبّتون التطبيق تتولّى الواجهة البرمجية كل ما يجري
داخل متاجرهم. قاعدة البيانات تغطّي أعلى قمع المبيعات، والواجهة البرمجية تغطّي المنتج.

أما فرق البرمجيات والتقنية المالية والشحن والوكالات التي لا تبني تطبيقًا على سلة، فتحتاج غالبًا قاعدة
البيانات وحدها — فالواجهة البرمجية لا تقدّم لها شيئًا ما لم يفوّض تاجرٌ تطبيقًا تابعًا لها.

## المصادر والمنهجية

سلوك الواجهة البرمجية ملخّص من توثيق سلة للمطوّرين —
[النظرة العامة](https://docs.salla.dev/)، و[التفويض](https://docs.salla.dev/doc-421118)، و[أحداث التطبيق](https://docs.salla.dev/doc-421413) — كما
قُرئ في 24 أكتوبر 2026. الواجهات البرمجية تتغيّر، فراجع التوثيق الحالي قبل البناء. وأرقام SallaData من نسخة
أكتوبر 2026؛ راجع [المنهجية](/ar/methodology/).

سلة منتج تابع لشركته الخاصة ولا علاقة له بـ SallaData. وسجلات SallaData مصدرها
معلومات عامة موضّحة في المنهجية.

## أسئلة ذات صلة

[كيف تجد عملاء لتطبيقك على سلة؟](/ar/questions/how-to-find-customers-for-a-salla-app/)
[كم عدد متاجر سلة؟](/ar/questions/how-many-salla-stores/)
[كيف تجد متاجر سلة؟](/ar/questions/how-to-find-salla-stores/)

## تحتاج القائمة لا الواجهة البرمجية؟

41,038 متجرًا موثّقًا على سلة في ملف واحد — CSV وExcel وJSON.

[Get SallaData](/#get-access)

---
Source: https://salladata.com/ar/questions/salla-api-vs-store-database/ (updated 2026-10-24)