Binance Fast API ба гараар үүсгэсэн API түлхүүр: юу өөрчлөгдөх вэ?

«Шуурхай холболт»-ын ард Fast API — үр дүн нь мөн л API түлхүүр

Ханшийн самбар, хуулбар арилжааны үйлчилгээ, бот платформын олонх нь Binance-тэй холбох алхам дээр хоёр сонголт өгдөг. Нэг нь API Key, Secret Key оруулах хоёр талбар. Нөгөө нь «Шуурхай холбох», «Binance-ээр холбох» гэх мэт бичигтэй ганц товч. Тэр товчны ард Binance-ийн Fast API ажилладаг.

Binance-ийн тусламжийн төвийн «What Is Fast API and How Does It Work?» нийтлэл (2022 оны 6-р сарын 22-нд нийтэлсэн) үүнийг ингэж тайлбарладаг: хэрэглэгч гуравдагч талын (API брокер) платформ дээрх шуурхай холболтын товчоор Binance дансандаа нэвтэрч, тодорхой эрх олгоход API түлхүүр автоматаар үүсч тэр платформд холбогдоно. Ингэснээр түлхүүрийг өөрөө үүсгэж, хуулж оруулах ажил алга болно.

Тиймээс нэг товчоор өгсөн эрхийг API-аас «хөнгөн» холболт гэж ойлгож болохгүй. Хасагдах нь үүсгэх, хуулах, буулгах хэдэн алхам л. Платформд очих зүйл нь таны дансны интерфэйсийг дуудаж чадах API түлхүүр хэвээр бөгөөд эрх, IP хязгаарлалт, цуцлах арга гэсэн асуулт бүгд хэвээр хамаарна.

Зөвшөөрсний дараа Binance платформд юу өгдөг вэ

Тусламжийн төвийн тэр хуудсан дахь схемд гурван тал бий: хэрэглэгч API брокерт дансны эрх олгоно, брокер Binance-ээс API түлхүүр хүснэ, Binance шифрлэсэн API түлхүүрийг буцааж илгээнэ.

Энэ ажлыг гүйцэтгэдэг интерфэйс POST /v1/api-key/create («Create API key for User»)-ийн хөгжүүлэгчийн баримт бичигт нарийвчлал нь бий:

• Платформ таныг зөвшөөрөл өгөхөд авсан хандалтын токеноор (хүсэлтийн толгой дахь Bearer access token) энэ интерфэйсийг дуудаж, түлхүүрийг таны өмнөөс үүсгэнэ.
• Хүсэлтэд платформ өөрийн RSA нийтийн түлхүүрийг хавсаргана. Binance шинэ түлхүүрийг түүгээр шифрлэж, платформ өөрийн хувийн түлхүүрээр тайлна.
• Хариунд apiKey, secretKey хоёулаа ирнэ.

Гол нь сүүлийн мөр. Гараар холбоход Secret Key ядаж нэг удаа таны дэлгэц дээр гарч, хаана хуулж оруулснаа та мэддэг. Fast API-д бол үүссэн мөчөөсөө эхлэн зөвхөн платформын талд байна. Платформ түүнийг хэрхэн хадгалдаг, шифрлэж хадгалдаг эсэх, ажилтнуудаас хэн харж чадах вэ гэдгийг платформын өөрийнх нь аюулгүй байдлын тайлбараас л мэдэх боломжтой; Binance-ийн хуудас энэ хэсгийг хамардаггүй.

Түлхүүрийн нэрийг (apiName) ч платформ хүсэлтдээ бичдэг бөгөөд баримт бичигт нэр давхцаж болно гэж заасан. Дараа нь дансныхаа жагсаалтаас энэ түлхүүрийг ямар нэрээр харах нь платформ анх юу гэж бичсэнээс шалтгаална.

• Binance тусламжийн төв · What Is Fast API and How Does It Work? ↗
• Binance хөгжүүлэгчийн баримт бичиг · Create API key for User ↗

Fast API түлхүүрт ямар эрх нээгдэх вэ, хөрөнгө гаргах эрх бий юу

Дээрх интерфэйсийн хүсэлтэд эрхтэй холбоотой дөрвөн унтраалга бий: enableTrade (спот арилжаа), enableFutureTrade (фьючерс), enableMargin (маржин), enableEuropeanOptions (Европ опцион). Сүүлийн хоёрыг платформ илгээгээгүй, эсвэл таны дансанд холбогдох дансны төрөл нээгдээгүй бол анхдагч утга нь false байна.

Параметрийн жагсаалтад хөрөнгө гаргах унтраалга байхгүй. Fast API-аар үүссэн түлхүүрт дараа нь өөр аргаар хөрөнгө гаргах эрх нэмж болох эсэхийг баримт бичигт бичээгүй. Арилжааны хэрэгсэлд энэ эрх угаасаа хэрэггүй; яагаад гэдгийг унших, арилжаалах, хөрөнгө гаргах эрхийн тайлбар хэсгээс уншина уу.

IP хязгаарлалтыг status талбар тодорхойлно: 1 эсвэл хоосон бол IP хязгааргүй, 2 бол зөвхөн итгэмжлэгдсэн IP, 3 бол зөвхөн итгэмжлэгдсэн гуравдагч талын IP. Итгэмжлэгдсэн хаягийг ipAddress-д бичих бөгөөд нэг түлхүүрт хамгийн ихдээ 30 хаяг. Баримт бичигт нэг хатуу дүрэм бас бий: арилжааны аль нэг эрх (спот, маржин эсвэл фьючерс) нээхийн тулд IP хандалтыг заавал хязгаарлана.

Өөрөөр хэлбэл захиалга өгч чадах Fast API түлхүүр IP-д уягдсан байх ёстой бөгөөд ихэвчлэн платформын серверийн гадагш гарах хаягт уягдана. Зөвшөөрлийн дэлгэц дээр хүссэн эрх эсвэл IP харагдаж байвал зөвшөөрөхөөсөө өмнө тэр жагсаалт таны хэрэгслээр хийлгэх гэж буй ажилтай таарч байгаа эсэхийг хар. Юу ч харуулаагүй бол дараа нь дансандаа шалга (доор бичсэн).

Түлхүүрээ өөрөө үүсгэхэд таны гарт үлдэх шийдвэрүүд

Тусламжийн төвийн «How to Create API Keys on Binance?» (сүүлд 2025 оны 3-р сарын 20-нд шинэчилсэн) нийтлэлд зам нь: профайлын дүрс → Account → API Management → Create API. Үүсгэхээс өмнө гурван нөхцөл хангагдсан байх ёстой: хоёр шатлалт баталгаажуулалт асаасан, Spot Wallet-д ямар нэг дүн цэнэглэсэн, хувийн мэдээллийн баталгаажуулалт хийсэн.

Энэ замаар явбал дараах зүйлсийг хэрэгсэл бус та өөрөө шийднэ:

1. Түлхүүрийн төрөл. Системийн үүсгэсэн түлхүүр нь HMAC тэгш хэмт түлхүүр; өөрөө үүсгэвэл Ed25519 эсвэл RSA бөгөөд Binance-д зөвхөн нийтийн хэсгийг өгнө. Алийг сонгох нь хэрэгсэл юуг дэмждэгээс хамаарна; дэлгэрэнгүйг HMAC, RSA, Ed25519-ийн тухай заавар хэсэгт бичсэн.
2. Шошго. Зориулалтаа танихуйц нэр өг, жишээ нь хэрэгслийн нэр, огноо. Дараа нь цэвэрлэхэд жагсаалтаа уншаад л ялгана.
3. IP хязгаарлалт. Тусламжийн хуудсанд IP хандалтын хязгааргүй HMAC түлхүүр уншихаас өөр эрхгүй, хөрөнгө гаргах эрх нээхийн тулд IPv4 хэлбэрийн IP хязгаарлалт заавал нэмнэ гэж бичсэн. Ямар хаяг оруулахыг хүсэлт хаанаас гарч байгаагаас эхлэн IP зөвшөөрлийн жагсаалтын заавар тайлбарлана.
4. Эрхийн унтраалга бүр, мөн дараа нь аль нэгийг өөрчлөх эсэх.

Үүний төлөөс нь Secret Key таны гараар дамжина. Binance-ийн API-ийн түгээмэл асуултад Secret Key зөвхөн үүсгэх үед харагддаг, алдвал шинэ түлхүүр үүсгэхээс өөр аргагүй гэжээ. Мөн тэр хуудсанд API түлхүүрээ гуравдагч талын платформд оруулах нь аюулгүй байдлын эрсдэлтэй, Binance гуравдагч талын үйлчилгээг дэмждэггүй гэж анхааруулсан. Тиймээс хуулсан даруйдаа хэрэгсэлд оруулаад хуудсаа хаа; чат, дэлгэцийн зураг, хуваалцсан баримт бичигт хадгалж болохгүй.

• Binance тусламжийн төв · How to Create API Keys on Binance? ↗

Шуурхай холболт уу, гараар оруулах уу: гурван асуулт

Аль нь ч угаасаа илүү аюулгүй биш; хоёр зам эрсдэлийг өөр өөр газар байршуулдаг. Энэ удаагийн холболтод алийг нь сонгохыг дараах гурван асуулт ихэвчлэн шийднэ:

• Унтраалга бүрийг өөрөө сонгомоор байна уу? Зөвхөн уншуулж, фьючерс өгөхгүй гэх мэтээр нарийн хянамаар бол өөрөө үүсгэсэн түлхүүр шууд хүргэнэ. Fast API-д эрхийн багцыг платформ санал болгодог; таны хийх зүйл нь зөвшөөрлийн дэлгэцийг уншиж, дараа нь шалгах.
• Хэдэн платформ холбох вэ? Fast API хуудсанд нэг Binance данс Fast API-аар нэг брокер платформд зөвхөн нэг удаа холбогдоно гэсэн хязгаар бий. Хэд хэдэн үйлчилгээг зэрэг туршиж үзэх бол заримыг нь гараар холбох магадлал өндөр.
• Хэрэгсэл хэний машин дээр ажиллах вэ? Өөрийн скрипт, өөрийн серверт зөвхөн өөрөө үүсгэсэн түлхүүр ашиглана. Fast API бол Binance-ийн шалгалтад тэнцсэн брокер платформд зориулагдсан: тусламжийн хуудсанд платформ байгууллагын шалгалт болон OAuth аюулгүй байдлын шалгалтад тэнцэж байж холбогдоно гэж бичсэн.

Хэрэгсэл хоёр аргыг хоёуланг нь санал болгож, зөвхөн үлдэгдэл унших хэрэгтэй бол өөрөө үүсгэсэн зөвхөн унших түлхүүр ихэнхдээ илүү цэгцтэй: эрх нь ил тод, шошгыг та өгсөн, дараа нь устгахад аль нь болохыг таах хэрэггүй. Арилжаа хийлгэх бол шуурхай холболт нь платформын гадагш гарах IP-г хайх ажлаас чөлөөлнө. Гэхдээ Secret Key эхнээсээ зөвхөн платформын талд байхыг хүлээн зөвшөөрч байж л тэр замыг сонго.

Хэрэгслээ болиход аль ч түлхүүрийг API Management-д хаана

Fast API-ийн тусламжийн хуудас ч, хөгжүүлэгчийн баримт бичиг ч зөвшөөрлийг цуцлах газрыг бичээгүй. Тодорхой нь Fast API таны дансанд API түлхүүр үүсгэдэг тул гарах зам нь гараар холбосонтой адил. Хэрэгсэл дотор «Салгах» дарах, эсвэл аппыг устгах нь төгсгөл биш; Binance дансны талд түлхүүрийг өөрийг нь шийдэх хэрэгтэй.

Дараах дарааллаар хий:

1. API Management-ийг нээж, түлхүүр бүрийн шошго, үүсгэсэн цаг, эрхийг нэг бүрчлэн хар. Fast API-ийн түлхүүр платформын өгсөн нэртэй байна: платформын нэр ч байж болно, танихгүй тэмдэгтийн мөр ч байж болно.
2. Зориулалт нь тодорхойгүй, хэн үүсгэснийг санахгүй түлхүүр байвал үүсгэсэн цаг нь таны зөвшөөрөл өгсөн өдөртэй таарч байгаа эсэхийг хар.
3. Өөр хэрэгсэл ашиглахгүй байгааг баталсны дараа эхлээд хэрэгсэл дотроо салга (хуучин түлхүүрээр дахин оролдохгүйн тулд), дараа нь түлхүүрийг устга.

API Management-ээс тохирох түлхүүр олдохгүй атал хэрэгсэл «холбогдсон» гэж харуулсаар байвал дэлгэцийн зураг, цагийг нь хэрэгслийн дэмжлэгт илгээж тодруул; шаардлагатай бол Binance-ийн дэмжлэгтэй холбогдож баталгаажуул. Ердийн байдлаар болих бүрэн жагсаалтыг хэрэгслээ болисны дараах шалгах жагсаалт хэсэгт оруулсан. Түлхүүр задарсан гэж сэжиглэж байвал дараалал өөр тул шууд төлөвлөгөөт түлхүүр солилт ба яаралтай цуцлалт заавар руу ор.

«Binance эрх цуцлах» гэж хайхад гарах хэтэвчний зөвшөөрөл

Binance-ийн зөвшөөрөл цуцлах тухай хайхад API-ийн хуудсуудтай зэрэгцэн Binance Wallet (Web3 хэтэвч)-ийн агуулга гарч ирдэг, жишээ нь тусламжийн төвийн блокчэйн зөвшөөрлийг удирдах заавар. Тэнд яригдаж буй зөвшөөрөл бол таны хэтэвч дэх токеныг ухаалаг гэрээ зарцуулж болохыг сүлжээн дээр зөвшөөрсөн хэмжээ бөгөөд цуцлах нь мөн хэтэвч дотор хийгддэг.

Энэ нь энэ зааварт яригдаж буй API хандалтаас тусдаа систем. Нэг нь гэрээ сүлжээн дээрх хэтэвчнээс хэр зарцуулж болохыг, нөгөө нь гуравдагч талын хэрэгсэл биржийн дансны интерфэйсийг дуудахыг зохицуулна. Хэтэвчний зөвшөөрлийг цуцалсан ч биржийн API түлхүүр хүчинтэй хэвээр; эсрэгээрээ ч адил. Аль төрлийг нь өгснөө мэдэхгүй бол хаана болсныг санаарай: арилжааны хэрэгсэл дотор «Binance-тэй холбох» дарсан бол API Management-д хамаарна; хэтэвчээр dApp холбож, зөвшөөрөлд гарын үсэг зурсан бол хэтэвчинд хамаарна.

Юу ч холбохоос өмнө зориулалт ба эрхээ нэг тойм шалгамаар бол эрх шалгах хэрэгсэл ашигла.