WEEX Broker necə olmaq olar: müraciət, API sazlanması və istifadəyə vermə

WEEX Broker olmaq üçün WEEX-in broker səhifəsindəki qoşulma formasını göndərin, müvafiq yoxlamadan keçin və WEEX-dən sonra altı rəqəmdən ibarət broker ID-si alın. Bundan sonra texniki işlər başlayır: istifadəçiləri OAuth və ya onların öz API açarları vasitəsilə qoşun, hər sifarişin əvvəlində broker ID-sini göstərin və komissiyaları rebate endpoint-ləri vasitəsilə tutuşdurun. WEEX təsdiq üçün bir iş günü, istifadəyə vermək üçün isə dörd-beş iş günü nəzərdə tutur. Aşağıdakı bölmələr bu ardıcıllığı izləyir, hazırlamalı olduğunuz məlumatları sadalayır və başqalarının açarlarını saxlamaqla bağlı təhlükəsizlik tədbirlərini əhatə edir. Məlumatlar 7 okt. 2026-cı il tarixinə aktualdır.

Kimlər müraciət edə bilər və WEEX nə tələb edir

Fərdi şəxslər, komandalar və şirkətlər müraciət edə bilər, depozit tələb olunmur. WEEX Broker səhifəsindəki FAQ-da kvant komandaları, maliyyə institutları və icma KOL-ları uyğun müraciətçilər kimi göstərilir, yoxlama isə standart lazımi araşdırma prosesi kimi təsvir olunur.

Formanı doldurmaq asandır. Sonrakı OAuth qeydiyyatı daha çox məlumat tələb edir və onları əvvəlcədən toplamaq sizə günlər qazandıra bilər:

• Platformanın adı, ingilis dilində
• Broker kimliyinə bağlanacaq WEEX UID-si
• Məxfilik siyasətinizin və xidmət şərtlərinizin URL-ləri
• Platformanın loqosu
• Əlaqələndirici şəxs və e-poçt ünvanı
• Bir və ya daha çox callback URL
• Serverlərinizin sorğuları göndərdiyi açıq IP ünvanları

İki məqam komandaları çaşdıra bilər. Müraciət etməzdən əvvəl WEEX hesabınız olmalıdır, çünki UID qeydiyyatın bir hissəsidir. Məxfilik siyasəti və xidmət şərtləri də aktiv səhifələrdə yerləşdirilməlidir.

WEEX Broker müraciət müddəti: formadan broker ID-sinə qədər

1. Formanı göndərin. Broker səhifəsindəki «İndi müraciət et» düyməsi formanı açır.
2. Yoxlamanı gözləyin. Broker səhifəsində 24 saat ərzində əlaqə saxlanacağı və «1 iş gününə təsdiq» vəd olunur. Broker API-yə giriş bölməsində biznesin inkişafı komandasının müraciətləri üç iş günü ərzində yoxladığı bildirilir. Daha uzun müddəti əsas götürün.
3. Təsdiq e-poçtunu alın. E-poçtda WEEX123456 kimi broker ID-si, ilkin komissiya dərəcəsi konfiqurasiyanız və texniki dəstək qrupuna giriş yer alır.
4. OAuth məlumatlarını əldə edin. WEEX callback URL-lərinizi və IP ünvanlarınızı qeydiyyata aldıqdan sonra clientId və secret key alırsınız.
5. İnteqrasiya edin və istifadəyə verin. WEEX-in 07.2026 tarixli elanında texniki inteqrasiyanın ikinci-dördüncü günlərdə, istifadəyə verilmənin isə beşinci gün planlaşdırıldığı bildirilir.

Təcrübədə qrafik WEEX-in yoxlamasından daha çox sizin tərəfin sabit callback URL-ləri və dəyişməz çıxış IP-lərini nə qədər tez təqdim etməsindən asılıdır.

İstifadəçiləri qoşmaq: WEEX OAuth prosesi 7 addımda

OAuth istifadəçiyə öz platformanızın WEEX-dəki səhifəsində icazə verməyə imkan yaradır və hazır API açarını backend-inizə göndərir. OAuth inteqrasiya təlimatında proses belə müəyyən edilir.

1. Backend-də birdəfəlik state dəyəri yaradın (22–128 simvol) və PKCE code_verifier yaradın: ən azı 43. Çağırış dəyərini Base64URL(SHA256(code_verifier)) kimi hesablayın. Qəbul edilən yeganə metod S256-dır.
2. İstifadəçini clientId, responseType=code, scope=create:apikey, state, redirectUri və çağırış dəyəri ilə birlikdə https://www.weex.com/az/oauth ünvanına yönləndirin.
3. İstifadəçi WEEX-də məlumatları nəzərdən keçirib təsdiqləyir.
4. WEEX istifadəçini code və state ilə callback-ə yönləndirir. State-in göndərdiyiniz dəyərlə uyğun olduğunu yoxlayın.
5. Backend-dən kod, redirectUri və code verifier ilə https://gateway.weex.com/v1/oauth/token ünvanına POST sorğusu göndərin. Sorğuda Client-Id, Sign, Timestamp və Nonce başlıqları olur. Sign sizin client secret-inizdən açar kimi istifadə etməklə timestamp, nonce, method, path və body dəyərlərinin HMAC-SHA256 nəticəsinin Base64 ilə kodlaşdırılmış formasıdır.
6. 3,600 saniyə etibarlı access token və 36,000 saniyə etibarlı refresh token alın. Yeniləmə əvvəlki access token-i etibarsız edir.
7. Bearer token ilə https://gateway.weex.com/v1/oauth/resource/create-api ünvanına POST sorğusu göndərin. Cavabda istifadəçinin apiKey, secret və passphrase məlumatları olur və bunlar yalnız bir dəfə qaytarılır.

Dizayna üç məhdudiyyət təsir edir. İstifadəçi müəyyən üçüncü tərəf platformasına yalnız bir API açarı bağlaya bilər; ikinci cəhd 81001, «api key already bound» xətası ilə nəticələnir. Qeydiyyatdan keçirmədiyiniz IP ünvanlarından gələn sorğular bloklanır. İstifadəçinin API statusu normal deyilsə, yeni açar dərhal işləməyə bilər; buna görə interfeysinizdə gözləmə statusu olmalıdır.

OAuth məcburi deyil. Platforma istifadəçilərin özlərinin yaradıb daxil etdiyi açarları da qəbul edə bilər. Aşağıda göstərilən sifariş teqləmə qaydası hər iki üsulda tələb olunur.

Sifarişləri teqləmək və komissiya uyğunluğunu yoxlamaq

Hər sifarişin client order ID-sinin əvvəlində broker ID-niz olmalıdır: newClientOrderId b-{brokerId} ilə başlamalıdır; məsələn, b-WEEX123456-20260319001. Bu qayda spot və fyuçerslərə aiddir.

Asanlıqla gözdən qaçan iki məqam var. Spot sifariş endpoint-ində client order ID sahəsi məcburi deyil və onu boş qoysanız, WEEX özü ID təyin edir. Bu şəkildə göndərilən sifarişdə broker prefiksi olmur, ona görə də bu sahəni hər sorğuda təyin edin. Uzunluq limitləri də fərqlidir: broker haqqında giriş bölməsində 64 simvol, fyuçers sifarişi endpoint-ində isə 1–36 simvol göstərilir. b-WEEX123456- prefiksi 13 simvoldan ibarətdir. ID-nin qalan hissəsini mövcud 23 simvola sığacaq şəkildə tərtib etsəniz, hər iki limitə uyğun olacaq.

Sonra Broker rebate API-dəki üç endpoint-dən istifadə edin:

• Uyğunluq. GET /api/v3/apiReferral/checkUserEligibility WEEX UID-si qəbul edir və istifadəçinin uyğun olub-olmadığını, səbəbi, həmçinin hesabın artıq başqa referral koduna bağlı olub-olmadığını qaytarır. İstifadəçi qoşularkən bu endpoint-i çağırın, nəticəni saxlayın və uyğun olmayan istifadəçiləri komissiya proqnozlarına daxil etməyin.
• Dərəcələr. GET /api/v3/apiReferral/rebateRatio sizin səviyyənizi (BRONZE, SILVER və ya GOLD) və altı nisbəti qaytarır: birbaşa dəvət olunanlar, referral kodu olmayan istifadəçilər və «Dostları dəvət et» referral-ları üçün spot və fyuçers nisbətləri.
• Qeydlər. GET /api/v3/apiReferral/rebate/recentRecord simvol və komissiya valyutası üzrə komissiya qeydlərini qaytarır; standart seçim SPOT-dur, FUTURES də seçilə bilər. Sorğu üçün maksimum müddət 90 gün, maksimum səhifə ölçüsü isə 100-dür.

Qeydlər simvol və hesablaşma dövrü üzrə, ticarət məbləği, komissiya, komissiya tutulması, rebate dərəcəsi və komissiya sahələri ilə qaytarılır. Onlarda istifadəçi ID-si və ya sifariş ID-si olmur. Məsələn, strategiya müəllifləri ilə gəliri bölüşdürmək üçün komissiyanı istifadəçilər üzrə ayırmaq istəyirsinizsə, client order ID əsasında öz sifariş reyestrinizi aparın. Broker səhifəsində komissiyaların gündəlik hesablaşdığı bildirilir.

Brokerlər üçün API açarlarının təhlükəsizliyi: başqalarının açarlarını saxlamaq

İlk istifadəçi hesabını qoşan kimi verilənlər bazanızda real vəsaitlərlə ticarət edə bilən məlumatlar saxlanılır. WEEX-in sənədləri minimum tələbləri müəyyən edir, diqqətli broker isə onlardan daha artığını edir.

• Gizli məlumatları backend-də saxlayın. OAuth təlimatında client secret, code verifier, eləcə də hər istifadəçinin secret key və passphrase məlumatlarının frontend kodunda heç vaxt görünməməli olduğu bildirilir. Broker FAQ-da açarların, secret-lərin və passphrase-lərin URL parametrlərində ötürülməməli olduğu da qeyd edilir. Callback-dən sonra təmiz səhifəyə yönləndirin və frontend-in statusu əldə etməsinə imkan verin.
• Saxlanılan açarları şifrələyin və jurnallarda maskalayın. Tam secret olan debug jurnalı, əks halda etibarlı sistemlərdən açarların sızmasının ən çox rast gəlinən səbəbidir.
• Çıxış IP-lərinizi sabit saxlayın. WEEX qeydiyyatdan keçməmiş ünvanlardan gələn sorğuları bloklayır. Qeydiyyatı yeniləmədən bulud regionunu dəyişmək və ya proxy əlavə etmək bütün istifadəçiləri eyni anda oflayn vəziyyətə sala bilər.
• Birdəfəlik qaytarılma ehtimalını nəzərə alın. create-api uğurla tamamlandıqdan sonra yaddaşa yazma uğursuz olarsa, secret itir və istifadəçi açarı silib yenidən qoşmalıdır. Bu addımı tranzaksiyalı edin.
• Yalnız zəruri icazələri istəyin. Sub-account üsulunda yalnız oxuma icazəsindən artıq hər hansı açar üçün 10-a qədər ünvandan ibarət IP allowlist tələb olunur. Yalnız məhsul vəsaitləri köçürürsə TRANSFER və ya WITHDRAW icazəsi istəyin.
• Limitlərə əməl edin. REST çağırışları hər 10 saniyədə ümumilikdə 500 çəki limitini bölüşür. HTTP 429 cavabından sonra sorğuları azaldın və sızmış məlumatların yoxlanması əlaməti ola biləcək ardıcıl avtorizasiya uğursuzluqları barədə xəbərdarlıq qurun.

İlk real istifadəçidən əvvəl istifadəyə vermə yoxlama siyahısı

• Test hesabında bütün prosesi yoxlayın: hesabı qoşun, uyğunluq nəticəsi true olsun, teqlənmiş sifariş icra edilsin və növbəti hesablaşmadan sonra əməliyyat komissiya qeydində görünsün.
• Başlıqda göstərilən rəqəmə güvənmək əvəzinə, dərəcə endpoint-indən səviyyənizi və nisbətlərinizi təsdiqləyin.
• Client order ID formatını həm spot, həm də fyuçersdə yoxlayın.
• Köhnə state dəyərini və artıq istifadə olunmuş avtorizasiya kodunu yenidən göndərin. Hər ikisi rədd edilməlidir.
• Qeydiyyatdan keçməmiş IP-dən sorğu göndərməyə çalışın. Sorğu bloklanmalıdır.
• Real vəsaitlərdən istifadə etmədən sifariş məntiqini yoxlamaq üçün WEEX-in fyuçers API FAQ-sında təsvir olunan /sim/ yolu altındakı demo endpoint-lərdən istifadə edin.
• Dəstək üçün əməliyyat təlimatı hazırlayın. WEEX-in sənədlərində [email protected] və Telegram icması göstərilir, təsdiqlə birlikdə isə texniki dəstək qrupu təqdim olunur.

WEEX Broker olmaq üçün forma göndərmək və qısa yoxlamadan keçmək kifayətdir. Komissiyanı düzgün almaq üçün sifarişləri intizamla teqləmək, hər istifadəçinin uyğunluğunu yoxlamaq və gündəlik işləyən tutuşdurma prosesi qurmaq lazımdır. Müraciət WEEX Broker səhifəsində başlayır.

FAQ

1. WEEX Broker təsdiqi nə qədər çəkir?

WEEX-in broker səhifəsində 24 saat ərzində əlaqə saxlanacağı və təsdiqin bir iş gününə başa çatacağı vəd olunur. API sənədlərində isə biznesin inkişafı komandasının müraciətləri üç iş günü ərzində nəzərdən keçirdiyi bildirilir. WEEX-in 07.2026 tarixli elanına əsasən, texniki inteqrasiya daha sonra təxminən dörd-beş iş günü çəkir.

2. WEEX Broker olmaq ödəniş tələb edirmi?

Xeyr. Broker səhifəsində depozit tələb olunmadığı və başlamağın heç bir xərcinin olmadığı bildirilir. Müraciət edənlər standart lazımi yoxlama prosesindən keçir, təsdiqlənmiş brokerlər isə broker backend-inə və məlumat panelinə ödənişsiz giriş əldə edirlər.

3. WEEX broker ID-si necə görünür?

Bu, WEEX sözündən sonra gələn altı rəqəmdir; məsələn, WEEX123456. ID təsdiq e-poçtu ilə göndərilir. Platformanın göndərdiyi hər sifarişin client order ID-si b- prefiksi və həmin ID ilə başlamalıdır.

4. Platforma WEEX Broker ilə OAuth olmadan inteqrasiya edə bilərmi?

Bəli. İstifadəçilər WEEX-də API açarları yaradıb platformaya əl ilə daxil edə bilərlər. OAuth bu əl ilə görülən addımı aradan qaldırır; sifarişlərin teqlənməsi və komissiya endpoint-ləri isə hər iki üsulda eyni cür işləyir.