چیست و چگونه آن را تنظیم کنیم؟ API

 

API چیست؟

API مخفف (Application Programming Interface) مجموعه ای از توابعی است که اجازه ایجاد برنامه هایی را می دهد که به ویژگی ها یا داده های یک سیستم عامل، برنامه کاربردی یا خدمات دیگر دسترسی دارند.  به عبارت ساده، برای خرید و فروش ارزهای دیجیتال، API امکان ارتباط با صرافی را برقرار می‌کند، دسترسی به داده های بازار به صورت هم‌زمان را امکان‌پذیر می‌کند و همچنین امکان انجام معاملات و مدیریت حساب را نیز فراهم می‌کند.

 

برای چه کاری می توانم از آن استفاده کنم؟

پس از ساخت اکانت در صرافی کوینکس، توسعه دهندگان می توانند متناسب با نیازشان آی پی آی های مختلف را استفاده کنند و همچنین از ای پی آی برای ترید یا برداشت خودکار استفاده کنند.  از طریق ارتباط بین ای پی آی و صرافی، می توان ترید خودکار ارز دیجیتال و سایر عملکردها را طبق روال طراحی شده انجام داد.  برنامه نویسی و تعیین خاصیت (کمی سازی) دقیقاً یکسان نیستند.  شما همچنین می توانید برخی از عملکردهای کمکی مانند به دست آوردن قیمت بازار و اطلاعات عمیق در مورد خرید و فروش، خرید در فواصل زمانی منظم، تعیین قیمت و غیره را اجرا کنید.

 

مدارک (منابع)  API کوینکس :

 https://viabtc.github.io/coinex_api_en_doc/

 

چگونه API بسازیم؟

 ۱. وارد وبسایت https://www.coinex.com/ بشوید، وارد حساب خود شوید، روی [مدیریت API ] از منوی [حساب] در گوشه سمت چپ بالا کلیک کنید.

52-01.png

 ۲. پس از ورود به صفحه [مدیریت API] روی [ایجاد API ] کلیک کنید.

52-02.png

 ۳. [اشاره ای پی آی] (یعنی نام ای پی آی) و [آدرس ای پی قابل اعمال] را بر این اساس تنظیم کنید، مطابق با نیاز خود، [قابل برداشت] و [قابل معامله]  را علامت بزنید، کد SMS/GA را وارد کنید، و پس از تأیید روی [ایجاد] کلیک کنید.

52-03.png

توجه:

۱) هنگام پر کردن آدرس IP مربوطه، لطفاً آدرس IP را از  " ای پی آی دستگاه مورد نیاز" را وارد کنید.

۲) هر کلید خصوصی میتواند حداکثر ۵۰ آدرس آی پی را فعال کند و هر کاربر می تواند حداکثر ۵۰ جفت کلید خصوصی را ایجاد کند

 

 ۴. لطفاً پس از ایجاد، [ID دسترسی] و [ کلید خصوصی] خود را فقط برای خود نگه دارید.  و از آنجایی که کلید خصوصی زمانی که ایجاد می شود برای امنیت حساب شما فقط یک بار نشان داده میشود، لطفاً این صفحه را با دیگران به اشتراک نگذارید. لطفاً به دقت از آن حفاظت کنید.

52-04.png



 چگونه آدرس لیست سفید ایجاد کنیم؟

 ۱. وارد صفحه [مدیریت ای پی آی ] شوید و روی [اضافه آدرس در لیست سفید] کلیک کنید.

52-05.png

۲. اشاره را وارد کنید، [ آدرس برداشت ] یا [ آدرس کوینکس ] را انتخاب کنید، [کوین] و [ نوع شبکه ] را انتخاب کنید، آدرس را وارد کنید، کد SMS/GA را وارد کنید، و پس از تأیید روی [تایید] کلیک کنید.

52-06.png

۳. کد تأیید ایمیل را دریافت کرده و وارد کنید، و سپس روی [ارسال] کلیک کنید تا آدرس لیست سفید اضافه شود.

52-07.png

 

توجه:

۱. با API های قوی ارائه شده توسط کوینکس ، می توانید از خدماتی مانند استعلام بازار، ترید، واریز و برداشت استفاده کنید.  برای دستورالعمل، لطفاً به API مراجعه کنید.

 

۲. هر کاربر می تواند حداکثر ۵۰ جفت کلید خصوصی را ایجاد کند

 

۳. جفت کلید خصوصی API شبیه به جفت حساب و رمز عبور است. لطفاً به دقت از آن حفاظت کنید. برای امنیت، توصیه می کنیم آن را به یک IP متصل کنید.

 

۴. هر کلید خصوصی حداکثر می تواند به 50 آدرس IP متصل شود.

 

۵. هر API  در ۱۰ تا ۱۵ دقیقه پس از ایجاد موفقیت آمیز، در دسترس خواهد بود.



چگونه آدرس‌های لیست سفید برداشت را دسته‌ای اضافه کنیم؟

 

۱. به صفحه " مدیریت API " بروید و روی "اضافه کردن دسته ای" کلیک کنید.

57-08.png

۲. روی «دانلود قالب» کلیک کنید و برای  آپلود در بخش افزودن صفحه اطلاعات خواسته شده را وارد کنید، که شامل «آدرس»، «کوین»، «نوع شبکه»، «آدرس لیست سفید»، «شناسه تگ کوین»، و در آخر «کد TOTP » را وارد کنید

57-09.png

 

توجه داشته باشید:

 

۱) حداکثر ۱۰۰ آدرس لیست سفید را می توان در یک زمان اضافه کرد

 

 ۲) فقط از فایل با فرمت CSV پشتیبانی میشود

 

 ۳) شبکه موجود در فایل CSV باید با نوع زنجیره عمومی در صفحه واریز مطابقت داشته باشد.  مثال:  نوع شبکه ارز CSC است و شبکه موجود در فایل نیز باید CSC باشد.

کوین

شبکه

آدرس

ممو

CET

CSC

XXX

 

57-10.png

 

۴) اگر کد خطای "تعدادی از فیلدها مطابقت ندارد" گزارش شود، می توانید بررسی کنید که آیا شبکه، آدرس با ممو موجود در فایل مطابقت دارد یا خیر.

 

۳. کد تاییدی که به ایمیل شما ارسال شده است را وارد کنید.

52-11.png

۴. با موفقیت اضافه شد.

52-12.png

 

کد خطای رابط: 

کد خطا

توضیحات 

۰

موفق

۱

ارور

۲

خطای پارامتر

۳

خطای داخلی

۲۳

ممنوعیت آی پی

۲۴

این دسترسی آی دی وجود ندارد

۲۵

خطای امضای دیجیتال

۳۴

این دسترسی آی دی منقضی شده است

۳۵

خدمات در دسترس نیست

۳۶

پایان خدمات

۴۰

حساب اصلی و حساب فرعی مطابقت ندارند

۴۹

انتقال به حساب فرعی رد شد

۱۰۷

بالانس(موجودی) ناکافی

۱۵۸

هیچ مجوزی برای استفاده از این API وجود ندارد

۲۲۷

مهر زمانی اشتباه است، مهر زمانی باید در 60 ± ثانیه زمان سرور باشد

۶۰۰

شماره سفارش وجود ندارد

۶۰۱

سفارش سایر کاربران

۶۰۲

از حداقل محدودیت برای خرید یا فروش کمتر است

۶۰۶

قیمت سفارش بسیار از آخرین قیمت معامله فاصله دارد

۶۵۱

خطای عمق ادغام

کد خطای HTTP:

کد خطا

توضیحات 

۲۰۰

موفق

۴۰۴

API وجود ندارد

تعریف خطای کد WebSocket API:

کد خطا

پیام خطا

توضیحات 

۱

invalid argument

پارامتر نامعتبر

۲

internal error

خطای داخلی قرارداد