dzship — واجهة برمجية مجانية للشحن في الجزائر (Yalidine وZR Express وMaystro وNOEST وEcotrack بربط واحد)

كل مطوّر اشتغل على التجارة الإلكترونية في الجزائر يعرف هذه المعاناة: كل شركة توصيل عندها API خاص بها. طريقة مصادقة مختلفة، أسماء حقول مختلفة، حالات الطرود بالفرنسية أو العربية أو بأرقام مجردة — وتوثيق يتراوح بين الناقص والخاطئ. ربط شركة واحدة يأخذ أياماً؛ ودعم خمس شركات يعني صيانة خمسة أنظمة هشة إلى الأبد.

اليوم نحلّ هذه المشكلة للجميع. dzship واجهة برمجية عمومية ومجانية للشحن في الجزائر — طلب واحد بنفس الشكل لإنشاء وتتبّع وتسعير طرود الدفع عند الاستلام مع Yalidine وZR Express وMaystro وNOEST وأكثر من 30 شركة على منصة Ecotrack (DHD وConexlog وMSM Go وWorld Express وغيرها).

بدون تسجيل. بدون مفتاح API. بدون أي تكلفة.

لماذا جعلناها مجانية؟

DZBuild تحرّك يومياً طلبيات دفع عند الاستلام حقيقية عبر الولايات الـ58 كلها، ومنصتنا تتعامل أصلاً مع أكثر من 80 ربط توصيل. dzship تقدّم محرّك الشحن هذا — المجرّب في الإنتاج — كخدمة عمومية، لأننا نؤمن أن التقنية الجزائرية تنمو عندما تصبح البنية التحتية المملة والمؤلمة مشكلة محلولة — للجميع، وليس لتجّارنا فقط.

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

طلب واحد، أي شركة توصيل

ترسل بيانات اعتماد حسابك لدى شركة التوصيل مع كل طلب — لا تُخزَّن أبداً — وdzship يترجمها إلى اللغة التي تفهمها تلك الشركة:

curl -X POST https://freeship.dzbuild.com/v1/orders \
  -H 'Content-Type: application/json' -d '{
    "courier":     "yalidine",
    "credentials": { "apiId": "YOUR_ID", "apiToken": "YOUR_TOKEN" },
    "order": {
      "recipient": {
        "fullName":    "Amine Bouzid",
        "phone":       "0551234567",
        "wilayaCode":  16,
        "communeName": "Bab Ezzouar"
      },
      "deliveryType": "home",
      "productList":  "Sneakers Air x1",
      "codAmount":    4500
    }
  }'
# → 201 { "trackingNumber": "yal-ABC123", "status": "created" }

تغيير شركة التوصيل = تغيير قيمة courier وبيانات الاعتماد فقط. بقية الكود لا تتغير. والتتبّع يعمل بنفس الطريقة ويرجع مفردات حالات موحّدة عبر كل الشركات (picked_up، in_transit، out_for_delivery، delivered…)، فلا تضطر لوحة تحكمك أبداً لتحليل عبارة "Sorti en livraison" من جديد.

عملاء جاهزون لكل بيئة تطوير

لست مضطراً حتى لكتابة طلبات HTTP بنفسك. مستودع dzship على GitHub يوفّر عملاء برخصة MIT:

• Node.js — ‏npm install dzship (على npm): بدون أي اعتماديات، مع أنواع TypeScript مدمجة.

  import dzship from 'dzship';
  
  const client = dzship({
    courier: 'yalidine',
    credentials: { apiId: process.env.YAL_ID, apiToken: process.env.YAL_TOKEN },
  });
  const { trackingNumber } = await client.createOrder({ /* … */ });

• PHP — ملف واحد يعمل على أي استضافة مشتركة (مع وصفات جاهزة لـ Laravel وWooCommerce).

• Python — وحدة من ملف واحد تعتمد على المكتبة القياسية فقط، لـ Django وFlask وFastAPI أو أي سكريبت عادي.

• Google Sheets — سكريبت Apps Script جاهز لسيناريو "200 طلبية في جدول بيانات" الشهير.

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

ومعها مجموعة بيانات مجانية: كل الولايات والبلديات

بيانات العناوين السيئة تقتل التوصيل. المستودع يتضمن مجموعة بيانات في الملك العام (CC0) لكل الولايات الـ58 والبلديات الـ1,541 — بالأسماء الفرنسية والعربية، حسب التقسيم الحالي لما بعد 2021، بصيغتي JSON وCSV. استعملها في نماذج الطلب عندك، بدون أي شرط للإسناد:

const wilayas = await fetch(
  'https://raw.githubusercontent.com/DZBuild-com/dzship/main/data/wilayas.json'
).then((r) => r.json());

استعمال عادل، ومتاح عالمياً

dzship متاح من أي مكان في العالم ومحمي بحدود استعمال عادل (30 طلبية في الساعة لكل IP، وحصص تتبّع سخية) ليبقى سريعاً ومجانياً للجميع. المرجع الكامل ورموز الأخطاء والحدود: freeship.dzbuild.com.

قاعدة أمان واحدة: استدعِ الخدمة من الخادم الخاص بك، وليس أبداً من متصفح أو تطبيق موبايل — بيانات اعتماد شركة التوصيل يجب أن تبقى سرية.

عندما تحتاج أكثر من الشحن

dzship هو طبقة الشحن. إذا كنت تبني متجراً كاملاً لتاجر جزائري، فإن DZBuild هي الباقي: واجهات متاجر بالعربية والفرنسية، صفحات هبوط، إدارة طلبيات الدفع عند الاستلام مع مسارات التأكيد، أكثر من 80 شركة توصيل مربوطة مسبقاً، مخزون وتحليلات — متجرك يشتغل في دقائق، بدون برمجة.

في الحالتين، أطلق مشروعك. هذا هو المغزى.

ابدأ من هنا: freeship.dzbuild.com · github.com/DZBuild-com/dzship · npm install dzship