مرجع API · الشحن المباشر
حساب تكلفة الشحن المباشر
GET
/v1/wallets/{walletId}/direct-recharge-products/{productId}/quoteتحقّق من مبلغ التسليم وإجمالي ما سيُخصم قبل الشراء. عرض السعر لا يحجز مالًا وقد يتغيّر. منتجات الفواتير (billing) غير متاحة بعد.
الصلاحية
direct_recharges:readالمصادقةقراءة موقَّعة
ردّ أنيسغير موقَّع
حدود الموظفين التي يُحتسب ضمنهاكل الاستدعاءات
حزمة SDK لـ .NET
anis.DirectRechargeProducts.QuoteAsync(walletId, productId, amount, amountIn)المعاملات
| الاسم | الموضع | النوع | ملاحظات |
|---|---|---|---|
walletIdإلزامي | path | UUID | معرّف UUID بأحرف صغيرة مع الشرطات. |
productIdإلزامي | path | UUID | معرّف UUID بأحرف صغيرة مع الشرطات. |
amountإلزامي | query | string | المبلغ المراد حساب سعره كنص عشري. |
amountInإلزامي | query | string | تكون lyd للإدخال بالدينار، وfx للإدخال بعملة التسليم. |
الاستدعاء
موقَّعة بمفتاحك. بلا محتوى وبلا رقم استخدام لمرة واحدة (nonce).
الترويسات: Signature-Input، Signature، X-Anis-Date، Accept-Language (اختياري). تضبطها حزم SDK كلها نيابةً عنك.
المحتوى: لا يوجد.
الردود
| الحالة | المعنى | المحتوى |
|---|---|---|
| 200 | نجاح. | DirectRechargeQuote |
| 400 | مرفوض: الاستدعاء الموقّع غير سليم البنية. | مشكلة |
| 401 | مرفوض: لم تتم المصادقة. | مشكلة |
| 403 | مرفوض: غير مسموح. | مشكلة |
| 404 | مرفوض: غير موجود، أو ليس لك. | مشكلة |
| 409 | مرفوض: يتعارض مع الحالة الحالية. | مشكلة |
| 422 | مرفوض: الاستدعاء يخالف قاعدة. | مشكلة |
| 429 | مرفوض: بلغتَ حدًا. | مشكلة |
| 503 | لا قرار: خدمة مطلوبة غير متاحة. | مشكلة |
ردود هذا الاستدعاء غير موقَّعة — لا ترويسة Signature ولا Signature-Input، سواء في النجاح أو الرفض. لا شيء تتحقق منه؛ فحماية TLS تكفيها. وتبقى Content-Digest و X-Request-Id موجودتين.
حالات الرفض
رفض هذا الاستدعاء مشكلةٌ بلا توقيع. ابنِ منطقك على رمزها code؛ وكلٌّ منها يرتبط بصفحة تشرح معناه وما عليك فعله.
| الخطأ | الرمز | الحالة |
|---|---|---|
| بيانات اعتماد غير صالحة | invalid_credentials | 401 |
| استدعاء موقّع غير سليم البنية | malformed_signed_request | 400 |
| صلاحية غير كافية | insufficient_scope | 403 |
| عنوان المصدر غير مسموح | source_ip_not_allowed | 403 |
| تجاوزت حدّ الاستدعاءات | rate_limited | 429 |
| فشل التحقق | validation_failed | 422 |
| الخدمة غير متاحة | dependency_unavailable | 503 |
| انتهت مهلة الاستدعاء | request_timeout | 504 |
| خطأ داخلي | internal_error | 500 |
| الحساب غير مخوَّل | binding_not_authorized | 403 |
| الحساب غير فعّال | account_inactive | 403 |
| المحفظة غير ممنوحة | wallet_not_granted | 404 |
| غير موجود | resource_not_found | 404 |
| العملة غير مدعومة | currency_not_supported | 422 |
| منتج الشحن المباشر غير متاح | direct_recharge_product_unavailable | 409 |
| المبلغ خارج الحدود | amount_out_of_range | 422 |
الأنواع
DirectRechargeQuote
| الحقل | النوع | ملاحظات |
|---|---|---|
productIdموجود دائمًا | UUID | معرّف منتج الشحن المباشر المختار. |
payoutموجود دائمًا | DirectRechargePayout | نص مبلغ التسليم وعملته المسماة؛ وليس بصيغة Money للدينار. |
exchangeRateموجود دائمًا | string | سعر الصرف المعروض كنص عشري. |
priceموجود دائمًا | Money | السعر بالدينار الليبي مع تعديلات الموقع وشريحة المحفظة المطبّقة. |
commissionموجود دائمًا | Money | العمولة بالدينار الليبي المشمولة في total. |
totalموجود دائمًا | Money | إجمالي تكلفة المحفظة بصيغة Money وعملة LYD. فحص الرصيد دقيق حتى 999,999.999 LYD. |
DirectRechargePayout
| الحقل | النوع | ملاحظات |
|---|---|---|
amountموجود دائمًا | string | مبلغ التسليم كنص عشري. |
currencyموجود دائمًا | DirectRechargeCurrency | كائن اسم عرض عملة التسليم. |
DirectRechargeCurrency
| الحقل | النوع | ملاحظات |
|---|---|---|
nameموجود دائمًا | string | اسم العرض الوارد لهذا العنصر. |
Money
| الحقل | النوع | ملاحظات |
|---|---|---|
amountموجود دائمًا | string | نص عشري، وليس عدد JSON. قد يكون رصيد المحفظة سالبًا عند استخدام الدين المسموح. تتبع الأسعار والإجماليات قواعد المبلغ لكل مسار. |
currencyموجود دائمًا | string | رمز عملة من ثلاثة أحرف كبيرة، مثل LYD. اقرأ عملة المحفظة من balance.currency. |
asOf | string (date-time) | وقت قراءة هذا السعر أو الرصيد. |