مركز المساعدةمركز المساعدة / المطورون · مرجع
أنشئ عميلًا من نظامك، وحدّث العملاء الذين أنشأهم، واعرف الحسابات التي لا يستطيع تعديلها.
هذه الصفحة ترجمة آلية ولم تُراجع بعد.
POST /api/webhook/user-create يضيف عميلًا إلى متجرك، أو يحدّث عميلًا أنشأه نظامك من قبل. يحتاج إلى تفعيل Webhook المستخدم. راجع تبويب Webhooks/Pushers.
| الحقل | مطلوب | المعنى |
|---|---|---|
name | نعم | اسم العميل، حتى 255 حرفًا |
phone | نعم | رقم الهاتف، حتى 20 حرفًا |
external_id | لا | معرّف العميل في نظامك. أرسله في كل مرة: هو الطريقة الوحيدة للعثور على العميل عند التحديث |
email | لا | البريد الإلكتروني |
password | لا | كلمة مرور تسجيل الدخول للعميل، 6 أحرف أو أكثر. تُطبَّق عند التحديث، لا عند إنشاء العميل أول مرة |
address | لا | عنوان الشارع. حقول العنوان أدناه تُحفظ فقط إذا أُرسل هذا الحقل |
house, landmark, place_name | لا | رقم الشقة أو المنزل، علامة مميزة، اسم المنطقة |
latitude, longitude | لا | الموقع على الخريطة، كنصوص |
tag | لا | مقبول، حتى 100 حرف. هذا الطلب لا يحفظه |
is_active | لا | مقبول بالقيمة true أو false. هذا الطلب لا يحفظه |
| الحالة | النتيجة |
|---|---|
لا يوجد حساب بهذا external_id أو البريد الإلكتروني أو الهاتف | يُنشأ عميل ويُربط بمتجرك. الاستجابة: "User created successfully" |
قيمة external_id تخص عميلًا لمتجرك فقط، وليس له دور موظف | يُحدَّث ذلك العميل. الاستجابة: "User updated successfully" |
لا تطابق لـ external_id، لكن البريد الإلكتروني أو الهاتف يخص حسابًا موجودًا | يُرفض بـ HTTP 409، "This customer cannot be synced". يشمل ذلك العملاء الذين أنشأهم هذا الـAPI من قبل |
| المطابقة حساب موظف أو مالك أو مندوب أو مشرف | يُرفض بـ HTTP 409، "This customer cannot be synced" |
حسابات العملاء مشتركة بين المتاجر على المنصة. الشخص الذي سجّل بنفسه، أو يشتري أيضًا من متجر آخر، لا يمكن تغييره أو ربطه من نظامك.
نص التبويب نفسه يذكر أن العميل يُحدَّث أيضًا إذا كان رقم الهاتف معروفًا من قبل. الكود يرفض هذه الحالة.
name وexternal_id يُستبدلان عند إرسالهما.email وphone يتغيران فقط إذا لم يستخدم حساب آخر القيمة الجديدة. تغيير أيٍّ منهما يسجّل خروج العميل من كل الأجهزة.password يضبط كلمة مرور جديدة. لتمنح عميلًا جديدًا كلمة مرور، أرسل الطلب مرة أخرى بقيمة external_id نفسها.| الحالة | الرسالة | المعنى |
|---|---|---|
| 200 | "User created successfully" أو "User updated successfully" | data تحمل العميل |
| 401 | "Authentication failed" | رمز خاطئ أو مفقود |
| 401 | "User webhook is not enabled for this shop" | فعّل Webhook المستخدم واحفظ |
| 409 | "This customer cannot be synced" | راجع الجدول أعلاه |
| 422 | "Validation failed" | data تسرد رسالة لكل حقل |
لوضع العميل في قائمة أسعار، راجع أنواع التجار. ذلك الطلب يعثر على العميل بقيمة external_id نفسها.