🏢واجهة برمجة تطبيقات حالة التاجر
The Merchant Status API allows you to retrieve the current status of a specific merchant. This API can return details such as the merchant's status and protocol.
ملحوظة:
تأكد من اجتياز صالحةmerchant_idعند تقديم الطلب. إذا كان التاجر غير موجود أو لم يتم العثور عليه، فسوف تتلقى رسالة404 Not Foundخطأ.
- 🔹 تتطلب واجهة برمجة التطبيقاتمفتاح واجهة برمجة التطبيقاتللمصادقة.
- 🔹 الmerchant_idيجب أن يتم تمريرها كمعلمة استعلام في الطلب.
💡 طلب مثال
GET https://core.dinakel.com/api/gateway/v1/merchants/<merchant_id>/status
Headers:
Authorization: Bearer <your_api_key>
🔍 الرد المثالى
{
"status": true,
"statusCode": 200,
"data": {
"merchantStatus": "active"
}
}
⚠️ معالجة الأخطاء
توفر واجهة برمجة التطبيقات استجابات الخطأ التالية:
{
"status": false,
"statusCode": 400,
"message": "Invalid or missing merchant_id"
}
400 Bad Request:معلمة Merchant_id غير صالحة. تأكد من استخدام تنسيق المعرف الصحيح.
{
"status": false,
"statusCode": 404,
"message": "Merchant not found"
}
404 Not Found:التاجر صاحب المعرف المقدم غير موجود في النظام. تحقق مرة أخرى من معرف التاجر.
{
"status": false,
"statusCode": 500,
"message": "Internal server error"
}
500 Internal Server Error:حدث خطأ غير متوقع على الخادم. حاول مرة أخرى لاحقًا أو اتصل بالدعم.