معرفی

برای کسب اطلاعات بیشتر در مورد API V5 ، لطفاً دستورالعمل ارتقاء V5 را بخوانید.

احراز هویت

لطفاً برای تولید یک کلید API به Bybit's TestNet یا Maiet مراجعه کنید

نقطه پایانی پایه API:

• testnet: https://api-testnet. bybit.com
• Maiet (هر دو نقطه پایانی در دسترس هستند): https://api. bybit.com https://api. bytick.com

نوع کلید API خود را انتخاب کنید

• کلیدهای API تولید شده توسط سیستم: کلید API تولید شده توسط سیستم BYBIT با رمزگذاری HMAC کار می کند. به شما یک جفت کلیدهای عمومی و خصوصی ارائه می شود. لطفاً با این جفت کلیدها به عنوان رمز عبور رفتار کنید و آنها را ایمن نگه دارید.

برای تکمیل مراحل رمزگذاری ، اسکریپت های نمونه HMAC را دنبال کنید.

1. از Generator API-RSA برای ایجاد کلید خصوصی و عمومی RSA استفاده کنید. برای تکمیل مراحل رمزگذاری ، اسکریپت های نمونه RSA را دنبال کنید.

پارامترهای نقاط پایانی معتبر

کلیدهای هدر HTTP زیر باید برای تأیید اعتبار استفاده شود:

• X-bapi-api-Key-کلید API
• X-BAPI-Timestamp-Timestamp UTC در میلی ثانیه
• X-BAPI-SIGN-امضای حاصل از پارامترهای درخواست

ما همچنین X-BAPI-RECV-Window (واحد در میلی ثانیه و مقدار پیش فرض 5،000) را ارائه می دهیم تا مشخص کنیم چه مدت درخواست HTTP معتبر است. همچنین برای جلوگیری از حملات پخش مجدد استفاده می شود.

یک پنجره X-BAPI-recv کوچکتر امن تر است ، اما اگر زمان انتقال از پنجره X-BAPI-Recv شما بیشتر باشد ، ممکن است درخواست شما شکست بخورد.

لطفاً اطمینان حاصل کنید که پارامتر Timestamp به قانون زیر پایبند است: Server_time - recv_window server_time مخفف زمان Bybit Server است ، که می تواند از طریق نقطه پایان زمان سرور پرس و جو شود.

یک درخواست ایجاد کنید

برای کمک به تشخیص مشکلات پیشرفته شبکه ، ممکن است در نظر داشته باشید که CDN-request-ID را به عنوان های درخواست خود اضافه کنید. مقدار آن باید برای هر درخواست بی نظیر باشد.

مراحل اساسی:

1. Timestamp + API Key + (recv_window) + (queryString | JsonBodyString)
2. برای امضای رشته در مرحله 1 ، از الگوریتم HMAC_SHA256 یا RSA_SHA256 استفاده کنید و آن را به یک رشته HEX تبدیل کنید تا پارامتر علامت را بدست آورید.
3. پارامتر علامت را برای درخواست عنوان اضافه کنید و درخواست HTTP را ارسال کنید. توجه: متن ساده برای درخواست های دریافت و ارسال متفاوت است. لطفاً به نمونه های منفجر مراجعه کنید.

الگوریتم های امضاء مثال را می توان در اینجا یافت.

مثالی برای نحوه تولید متن ساده برای رمزگذاری

# قانون: timestamp+api_key+recv_window+querystring  # param_str "1658384314791XXXXXXXXXX5000CATEGORY = گزینه و نماد = BTC-29JUL22-25000-C"  # تجزیه زمان سنج = "1658384314791" کلید ای پی ای = "xxxxxxxxxx" recv_window = "5000" استرینگ = "دسته = گزینه و نماد = BTC-29JUL22-25000-C" 

# قانون: timestamp+api_key+recv_window+raw_request_body  # param_str 1658385579423XXXXXXXXXXX5000 "دسته بندی": "گزینه" >  # تجزیه زمان سنج = 1658385579423 کلید ای پی ای = xxxxxxxxxx recv_window = 5000 raw_request_body = "دسته بندی": "گزینه"> 

گرفتن /v5/سفارش/زمان واقعی؟ دسته = گزینه و نماد = BTC-29JUL22222000-C HTTP/1. 1 میزبان: api-testnet. bybit.com -h 'x-bapi-sign: xxxxxxxxxx'  -H 'x-bapi-api-Key: xxxxxxxxxx'  -H 'X-BAPI-Timestamp: 1658384431891'  -H 'X-bapi-recv-Window: 5000' -H 'CDN-request-id: test-001' 

پست /v5/سفارش/ایجاد HTTP/1. 1 میزبان: api-testnet. bybit.com -h 'x-bapi-sign: xxxxxxxxxx'  -H 'x-bapi-api-Key: xxxxxxxxxx'  -H 'x-bapi-timestamp: 1658385589135'  -H 'x-bapi-recv-window: 5000'  -H 'Content-Type: Application/JSON'  -H 'CDN-request-id: test-002' -d '"دسته": "گزینه" >' 

پارامترهای پاسخ مشترک

 "retcode": 0, "retmsg": "خوب", "نتیجه":  >, "retextinfo": >, "زمان": 1671017382656 >