نظرة عامة

اربط نظامك بأنيس: اشترِ البطاقات واشحن العدادات واطلب الشحن المباشر واستقبل النتائج الموقّعة.

يعتمد الوصول إلى المنتجات على صلاحيات تطبيقك والخدمات المفعّلة في بيئتك. يتضمنها الإصدار 2.2.0 من حزم SDK.

تشرح هذه الصفحة كيف تترابط هذه الأجزاء قبل أن تدخل بقية صفحات دليل الاستخدام في التفاصيل.

الأطراف

• تطبيقك — ما يُنشئه لك موظفو أنيس. له صلاحيات (أي الاستدعاءات يحق له إجراؤها)، والشبكات التي يجوز له الاستدعاء منها، وحدود اختيارية، والمحافظ التي يجوز له استخدامها.
• حسابك التجاري لدى أنيس — الحساب الذي تتبع له المحافظ. تُدفع المشتريات من محافظه.
• مفتاحك — زوج مفاتيح تُنشئه بنفسك. لا يغادر النصف الخاص جهتك أبدًا؛ ولا ترى أنيس إلا النصف العام. يمكن استبدال مفتاح التطبيق دون تغيير أي شيء آخر.

كل استدعاء موقّع، والردود المهمة يُتحقَّق منها

لا يوجد مفتاح API ترسله. بدلًا من ذلك:

1. أنت توقّع كل استدعاء بمفتاحك الخاص. تفحص أنيس التوقيع، وترفض كل ما لا تستطيع التحقق منه، قبل أن تنظر فيما طلبته.
2. أنيس توقّع الردود المهمة بمفتاحها هي — أي ما ينقل مالًا أو يسلّم البطاقات أو يُثبت مفتاحك: طلبات الشراء والكشف وتسجيل المفتاح والفحص الذاتي للتوقيع وتعليق تطبيقك وإلغاء مفتاح. يشترط برنامجك (client) وجود ذلك التوقيع ويتخلّص من الردّ إذا غاب أو فشل التحقق منه — فلا يُبنى أي إجراء أبدًا على ردّ مزوّر أو معدَّل. أما بقية الردود (ملف التطبيق والمحافظ والكتالوج والبطاقات المملوكة) فغير موقَّعة؛ وحماية TLS تكفيها.

التوقيع دقيق حتى مستوى البايت، ولهذا نوفّر حزم SDK التي تقوم به نيابةً عنك. إن كتبت برنامجك بنفسك، فإن دليلَي التوقيع والتحقق يقدّمان كل قاعدة.

ما يمكنك فعله

يسرد مرجع API كل استدعاء مع صلاحيته وحقوله وحالات رفضه.

لا يمكن أن يُشترى طلب مرتين بالخطأ

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

عنوان واحد، ولا شيء آخر لإعداده

تعطيك أنيس العنوان الذي تستدعيه. كل نسخة نشر لأنيس نسخة منفصلة تمامًا — لها عنوانها ومفاتيحها وبياناتها — لذا لا يوجد إعداد “بيئة” (environment) في أي مكان: العنوان وحده هو ما يحدد النسخة التي تتعامل معها، والمفتاح المسجَّل لدى إحداها لا يعني شيئًا لأخرى.