دليل واجهة API - توفير موني

وثائق مطوري توفير موني

معلومات API

رابط API: https://tawfeermoney.yemoney.net/api/yr/

معلومات مطلوبة

Userid = youruserid;
DomainName: domainname;
Username: yourloginName;
Password: yourpassword;
        

توليد التوكن

Method to generate required token:
GenerateToken(transid, mobile)
{
    Username: yourloginName;
    Password: yourpassword;
    hashPassword = md5(Password);
    token = md5(hashPassword + transid + Username + mobile);
    return token;
}
        

العمليات المتاحة

1. استعلام الرصيد

URL: http://DomainName/yem?action=query&userid=Userid&mobile=xxxx&transid=xxxx&token=xxxx;
المتغيرات:
- mobile: رقم الهاتف، يجب أن يكون بطول 9 أرقام. مثال: 774541452
- transid: معرف المعاملة، يجب أن يكون فريدًا لكل عملية. مثال: 123
- token: GenerateToken(transid, mobile);
        

2. فواتير الرصيد

URL: http://DomainName/yem?action=bill&userid=Userid&mobile=xxxx&transid=xxxx&token=xxxx&amount=xxx;
المتغيرات:
- amount: المبلغ المطلوب للفوترة.
        

3. استعلام العروض

URL: http://DomainName/yem?action=queryoffer&userid=Userid&mobile=xxxx&transid=xxxx&token=xxxx;
        

4. فواتير العرض

URL: http://DomainName/yem?action=billoffer&userid=Userid&mobile=xxxx&transid=xxxx&token=xxxx&offerid=xxx&method=xxx;
المتغيرات:
- offerid: معرف العرض، انظر جدول العروض.
- method: الطرق (جديد، تجديد، إزالة).
        

5. فواتير ADSL والخط الثابت

URL: http://DomainName/post?action=bill&userid=Userid&mobile=xxxx&transid=xxxx&token=xxxx&amount=xxx&type=xxx;
المتغيرات:
- type: نوع الخدمة (ADSL أو خط ثابت).
        

6. استعلام ADSL والخط الثابت

URL: http://DomainName/post?action=query&userid=Userid&mobile=xxxx&transid=xxxx&token=xxxx;
        

استجابة API

{"resultCode":"0", "resultDesc":"success"}
        

النجاح: "resultCode":"0"

خطأ: "resultCode":"10xx" حيث xx يساوي أي رقم.

قيد المعالجة: "resultCode":"-2", "resultDesc":"تحت المعالجة"

الملاحظات

- يجب أن يكون لكل عملية معرف معاملة فريد.
- تأكد من صحة رقم الهاتف وطول الرقم.
- استخدم MD5 لتشفير كلمة المرور.
        

وثائق المطورين