تكامل API/البوت

بِع العملات عبر API لدينا

يمكنك بيع العملات عبر API لدينا. للحصول على بيانات المصادقة، أضِف بوتًا في هذه الصفحة.

1

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

  1. الفاصل الزمني الأمثل لإرسال طلبات الحصول على اللاعبين هو ⁦10–15⁩ ثانية لكل منصة.
  2. يجب شراء اللاعب خلال 5 دقائق من استلامه.
2

الحصول على لاعب عشوائي لشرائه

الطلب
GEThttps://api.mydgn.com/transfers
الخاصيةالوصف
user* اسم مستخدم API
platform* cons, pc
timestamp* الطابع الزمني بصيغة UNIX
hash* تجزئة MD5: md5 (platform + user + timestamp + secret_key)
maximumBuyOutPrice* integer، الحد الأقصى لسعر اللاعب
minimumBuyOutPrice* integer، الحد الأدنى لسعر اللاعب
botapp string، API الخاص ببوتك
playerType 1 = أساسي، 2 = discard
مثال على الطلب
GEThttps://api.mydgn.com/transfers
{
    "user": "example",
    "platform": "cons",
    "timestamp": 1593766167,
    "hash": "ec7229f469c109866fad06a6652ae608",
    "maximumBuyOutPrice": 300000,
    "minimumBuyOutPrice": 4000,
    "botapp": "MyFifaBot",
    "playerType": 2
}
الاستجابة
الخاصيةالوصف
code رمز الاستجابة
transactionID integer، معرّف المعاملة المعيَّن من نظامنا، وعليك الاحتفاظ به للاستعلام لاحقًا (في مرحلة تحديث الحالة)
tradeID string، معرّف المعاملة المعيَّن لهذا اللاعب في EA
status دائمًا "buy"
platform منصة الحساب: console, pc
assetID معرّف مورد اللاعب في EA
resourceID معرّف مورد اللاعب في EA
baseID المعرّف الأساسي للاعب في EA
playerName اسم اللاعب
search_name اسم اللاعب الذي يُدخَل عند البحث في webApp
search_position رقم ترتيب اللاعب في قائمة النتائج عند البحث في webApp
position مركز اللاعب، حاليًا دائمًا "any"
rating تقييم اللاعب
rating_search التقييم الأساسي للاعب
startPrice سعر البداية للاعب
coinAmount السعر النهائي للاعب
paymentInUsd المبلغ المدفوع بالدولار (USD) عن هذا اللاعب
currentRateInUSD السعر الحالي بالدولار ($) لكل 10K
balance رصيدك الحالي بالدولار ($)
balance_user الرصيد الحالي بالدولار ($) لمستخدم API الخاص بك
cardValue سعر السوق الحالي للاعب على Futbin
cardAndFeeDeducted العملات المحوَّلة
lockExpires الطابع الزمني الذي يجب إرسال حالة اللاعب قبله
ea_expires_at الطابع الزمني لانتهاء عرض اللاعب في مزاد EA
customerID معرّف العميل
ignoreHash مصفوفة من قيم md5 (email) التي لا يمكن استخدامها لشراء اللاعب
IsIcon boolean، يحدد ما إذا كانت البطاقة ICON
owners المالكون
chemistry_style أسلوب الانسجام
isAtMinPrice سعر اللاعب عند الحد الأدنى لسعره
مثال على الاستجابة بصيغة JSON
{
    "code": 200,
    "transactionID": 99664,
    "tradeID": "283047969116",
    "status": "buy",
    "platform": "console",
    "assetID": 50534077,
    "resourceID": 50534077,
    "baseID": 202429,
    "playerName": "Danny da Costa",
    "search_name": "Danny da C",
    "search_position": 1,
    "position": "any",
    "rating": 87,
    "rating_search": 85,
    "startPrice": 197000,
    "coinAmount": 198000,
    "paymentInUsd": 1.21,
    "currentRateInUSD": 45.00,
    "balance": 1372.73,
    "balance_user": 12.89,
    "cardValue": 41500,
    "cardAndFeeDeducted": 146600,
    "lockExpires": 1616592852,
    "ea_expires_at": 1616592852,
    "customerID": 737180,
    "ignoreHash": ["2806056B2B92F8B0171EC37AA76B8344", "2D1835A4DE3FE52DBA5C404F05C8D3D9"],
    "IsIcon": 1,
    "owners": 4,
    "chemistry_style": "Hunter",
    "isAtMinPrice": false
}
مثال على خطأ عدم توفر لاعبين حاليًا
{
    "error": "not found",
    "code": 404
}
مثال على خطأ غياب الحقول المطلوبة
{
    "error": "there is no valid input",
    "code": 401
}
مثال على خطأ المصادقة ببيانات غير صحيحة
{
    "error": "co credential matched",
    "code": 400
}
خطأ تجاوز الحد الأقصى لعدد الطلبات في الدقيقة
{
    "error": "Too many requests, please increase delay",
    "code": 429
}
تم تعطيل البوت، ولإعادة تفعيله عليك التواصل مع الدعم
{
    "error": "bot disabled",
    "code": 403
}
3

تحديث حالة الطلب

بعد الانتهاء من العمل على هذا اللاعب، يجب إرسال طلب API لتحديث حالة الطلب. إذا تم شراء اللاعب فأرسل المعامل "status": "bought". وإذا لم تتمكن من شرائه أو رفضت شراءه فأرسل المعامل "status": "cancel".

يجب إرسال طلب API قبل الطابع الزمني lockExpires. وإلا ستحصل على خطأ.

الطلب
POSThttps://api.mydgn.com/status
الخاصيةالوصف
user* الاسم الفريد لبوتك في نظامنا
platform* cons, pc
timestamp* الطابع الزمني بصيغة UNIX
hash* تجزئة MD5: md5 (platform + user + timestamp + secret_key)
transactionID* integer، معرّف المعاملة المعيَّن من نظامنا
status* bought أو cancel
emailHash* md5 (email) للحساب الذي استُخدم لشراء اللاعب.
code integer، رمز الخطأ. الرموز المسموح بها:
551 -> اللاعب غير موجود
552 -> اسم اللاعب غير صحيح
553 -> عُثر على عدة لاعبين متطابقين
554 -> خطأ في الشراء
مثال على الطلب
POSThttps://api.mydgn.com/status
{
    "user": "example",
    "platform": "cons",
    "timestamp": 1593766167,
    "hash": "ec7229f469c109866fad06a6652ae608",
    "transactionID": 119412,
    "status": "bought",
    "emailHash": "2806056B2B92F8B0171EC37AA76B8344"
}
POSThttps://api.mydgn.com/status
{
    "user": "example",
    "platform": "cons",
    "timestamp": 1593766167,
    "hash": "ec7229f469c109866fad06a6652ae608",
    "transactionID": 119412,
    "status": "cancel",
    "emailHash": "",
    "code": 551
}
مثال على الاستجابة بصيغة JSON
{
    "code": 200,
    "status": "success"
}
مثال على خطأ غياب الحقول المطلوبة
{
    "error": "there is no valid input",
    "code": 401
}
خطأ رقم معاملة غير صحيح أو منتهي الصلاحية
{
    "error": "cannot buy order transaction #72983787",
    "code": 409
}
قيمة emailHash غير صحيحة: يجب أن تخص حسابات FIFA التي تستخدمها لشراء اللاعبين، لا بريدك الإلكتروني في myDGN!
{
    "error": "wrong emailHash",
    "code": 400
}