اتصال 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 = دیسکارد
نمونه درخواست
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 شناسه resource بازیکن در EA
resourceID شناسه resource بازیکن در EA
baseID شناسه base بازیکن در 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

به‌روزرسانی وضعیت سفارش

پس از پایان کار با این بازیکن باید درخواستی برای به‌روزرسانی وضعیت سفارش بفرستید. اگر بازیکن خریداری شده است، با پارامتر "status": "bought". اگر نتوانستید بازیکن را بخرید یا از خرید منصرف شدید، با پارامتر "status": "cancel".

درخواست باید پیش از تایم‌استمپ 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
}