Kody błędów API WEEX wyjaśnione: Szybka naprawa od 40001 do 43011

Większość błędów API WEEX nie oznacza tego, co sugeruje komunikat. Błąd 40009 API validation failed prawie nigdy nie oznacza, że Twój klucz jest zły — zazwyczaj oznacza, że Twój ciąg podpisu został złożony w złej kolejności. Błąd 40102 Trading pair configuration does not exist dla pary, która ewidentnie istnieje, zazwyczaj oznacza, że wysłałeś symbol futures do domeny spot. Dosłowne czytanie kodu to sposób, w jaki dziesięciominutowa poprawka zamienia się w całe popołudnie pracy.

To jest praktyczny przewodnik po kodach błędów API WEEX, z którymi faktycznie spotyka się integracja na żywo, pogrupowany według warstwy, w której wystąpił błąd, a nie według numeru. Każdy kod poniżej pochodzi z listy kodów błędów API WEEX opublikowanej 27 lipca 2026 r.; zasady podpisywania, czasu i limitów stawek pochodzą z dokumentacji API spot WEEX z tego samego dnia. Obie te rzeczy ulegają zmianie, więc sprawdź ponownie przed wdrożeniem.

Najpierw wyjaśnienie, ponieważ wyniki wyszukiwania je mieszają: ten artykuł dotyczy API giełdy kryptowalut WEEX (api-spot.weex.com i api-contract.weex.com). Nie ma to nic wspólnego z Apache Weex, wycofanym frameworkiem interfejsu użytkownika mobilnego Alibaba, który dzieli nazwę i zwraca błędy takie jak -1001. Jeśli Twoje ślady stosu wspominają o WXSDKInstance, korzystasz z niewłaściwej instrukcji.

Jak grupowane są kody błędów API WEEX

Oficjalna lista to płaska tabela. W praktyce kody dzielą się na siedem warstw diagnostycznych, a znajomość warstwy mówi, który plik otworzyć. To grupowanie jest najszybszym sposobem na skrócenie czasu debugowania, ponieważ warstwy 1–4 dotyczą Twojego klienta, a warstwa 7 w ogóle nie jest Twoim błędem.

Praktyczna zasada: jeśli kod zaczyna się od 400, podejrzewaj swoje żądanie. Jeśli zaczyna się od 43, podejrzewaj parametry zlecenia. Jeśli jest to 429, 40200 lub 40015, nie podejrzewaj niczego i wstrzymaj się.

Błędy uwierzytelniania API WEEX: 40001 do 40018

Ten zakres generuje najwięcej zgłoszeń do wsparcia i najmniej rzeczywistych problemów z poświadczeniami. Sześć z tych kodów rozwiązuje się poprzez naprawę sposobu tworzenia nagłówków, a nie poprzez generowanie nowego klucza.

Dwa szczegóły warto przyswoić. Zasady tworzenia podpisu WEEX definiują ciąg prehash jako timestamp + method.toUpperCase() + requestPath + "?" + queryString + body, HMAC-SHA256 z Twoim kluczem sekretnym, a następnie Base64. ? i ciąg zapytania są pomijane, gdy nie ma zapytania. Trzy rzeczy psują to w produkcji: małe get, ścieżka żądania zawierająca hosta oraz ciało JSON, które Twoja biblioteka HTTP ponownie serializuje po podpisaniu — kolejność kluczy się zmienia, bajty się zmieniają i otrzymujesz 40009.

Drugi szczegół to pułapka nazewnictwa. Tekst błędu cytuje nazwy nagłówków z podkreśleniami (ACCESS_KEY, ACCESS_SIGN, ACCESS_TIMESTAMP, ACCESS_PASSPHRASE), podczas gdy dokumentacja podpisu zapisuje je z myślnikami (ACCESS-SIGN, ACCESS-TIMESTAMP). Skopiuj formę używaną w dokumentacji endpointu, z którym się integrujesz i loguj surowe nagłówki sieciowe przy pierwszym udanym wywołaniu, zamiast ufać ciągowi błędu lub fragmentowi bloga.

40005 vs 40008: dwa różne błędy sygnatury czasowej

Te dwa są ciągle mylone, a niewłaściwa naprawa marnuje najwięcej czasu.

40005 Invalid ACCESS_TIMESTAMP to problem z formatem. Wartość nie jest 13-cyfrową epoką milisekundową — zazwyczaj jest to 10-cyfrowa epoka sekundowa z time.time() w Pythonie lub time() w PHP, albo ciąg ISO-8601. Nie udaje się natychmiast i konsekwentnie, przy każdym żądaniu, w tym pierwszym.

40008 Request timestamp has expired to problem z zegarem lub opóźnieniem. Format jest poprawny, ale wartość jest oddalona o więcej niż 30 sekund od czasu serwera WEEX. Żądania są ważne tylko przez 30 sekund, a podpis jest odrzucany, jeśli sygnatura czasowa odbiega o więcej niż 30 sekund od zegara serwera API w dowolnym kierunku — maszyna działająca szybko zawodzi tak samo mocno, jak ta działająca wolno.

Dryf zegara wewnątrz kontenerów jest najczęstszą przyczyną integracji, która "działała wczoraj". Jeśli nie możesz kontrolować NTP na hoście, odpytaj endpoint czasu serwera przy starcie, zapisz deltę i dodawaj ją do lokalnego zegara dla każdego podpisu.

Odrzucenia zleceń: 43001 do 43011 i 42002

Gdy uwierzytelnianie przejdzie, błędy przenoszą się do silnika dopasowującego. Te kody są tanie w naprawie, ale drogie w ignorowaniu, ponieważ bot, który ponawia odrzucone zlecenie w ciasnej pętli, trafi w ogranicznik stawek i zamaskuje prawdziwy problem.

To, co łapie doświadczonych traderów, to 40704 Only query data for the last three months. Uzupełnianie historii transakcji powyżej 90 dni nie zadziała przez standardowe endpointy zapytań, więc każde zadanie uzgadniania musi utrwalać wypełnienia w miarę ich występowania, zamiast zakładać, że może je pobrać później.

Co wyzwala błąd 429 w API WEEX

Zasady ograniczeń dostępu ustawiają domyślnie 10 żądań na sekundę, chyba że endpoint mówi inaczej. Przekroczenie tego zwraca 429 Too Many Requests, co lista błędów wyświetla również jako "Requesting too frequently".

Trzy właściwości tego limitu zmieniają sposób, w jaki powinieneś projektować wokół niego:

• Żądania uwierzytelnione są liczone na klucz API, żądania nieuwierzytelnione na publiczne IP. Dwa boty dzielące jeden klucz dzielą jeden budżet. Dwa boty na jednym serwerze z oddzielnymi kluczami nie — ale ich publiczne odpytywanie danych rynkowych tak, ponieważ jest liczone według IP.
• Zlecenie wsadowe na wielu parach liczy się jako jedno żądanie. Dokumentacja podaje przykład 4 par handlowych × 10 zleceń = 1 żądanie. Jeśli umieszczasz siatkę lub równoważysz księgę, przetwarzanie wsadowe nie jest mikrooptymalizacją; to 40-krotna różnica w przepustowości.
• Ponowne próby się liczą. Wykładniczy backoff, który ponawia próbę natychmiast po 429, utrzyma Cię w stanie ograniczenia. Wstrzymaj się z jitterem i porzuć przestarzałe zlecenia, zamiast ustawiać je w kolejce.

Praktyczny budżet: zarezerwuj około 60–70% limitu na przepływ zleceń, resztę zostaw na odpytywanie salda i pozycji, a wszystko, co możesz, przenieś do WebSocket. Księga zleceń i dane ticker przez REST to najczęstszy powód, dla którego dobrze zachowujący się bot handlowy kończy z ograniczoną stawką.

Błędy domeny bazowej i białej listy IP

Dwa błędy zgłaszają się na tyle źle, że zasługują na własną sekcję.

40102 Trading pair configuration does not exist dla pary, którą widzisz handlującą na stronie, zazwyczaj nie jest problemem symbolu. WEEX dzieli REST na https://api-spot.weex.com dla spot i https://api-contract.weex.com dla kontraktów. Symbol futures wysłany do domeny spot rozwiązuje się do pary, która faktycznie nie istnieje w tej domenie, a błąd jest technicznie dokładny i całkowicie mylący. Sprawdź hosta, zanim sprawdzisz symbol.

40018 Illegal IP request oznacza, że wywołujące IP nie znajduje się na białej liście klucza. Niezręczną częścią jest to, co zmienia je bez Twojej wiedzy: dostawca chmury rotujący IP wyjściowe, failover bramy NAT, ponowne połączenie VPN lub adres IPv6 używany, gdy na białą listę wpisałeś IPv4. Wskazówka wsparcia jest taka, że możesz utworzyć klucz, który nie jest powiązany z adresem IP, a dla klucza danych rynkowych tylko do odczytu jest to rozsądny kompromis. Dla klucza z uprawnieniami do handlu lub wypłat nie jest — niezwiązany klucz handlowy to poświadczenie na okaziciela, które działa z dowolnego miejsca w Internecie. Przypnij IP i monitoruj zmiany, zamiast usuwać kontrolę.

Szerszy kontekst dotyczący tego, jak powierzchnie REST i WebSocket pasują do siebie, jest omówiony w wyjaśnieniu Wiki WEEX na temat czy WEEX obsługuje handel API.

5-minutowa lista kontrolna triage API WEEX

Uruchom to w kolejności przed otwarciem zgłoszenia do wsparcia. Każdy krok izoluje jedną warstwę, a pierwsza awaria mówi, gdzie przestać szukać.

Jeśli każdy krok przejdzie, a wywołania nadal zawodzą, pozostałe kody — 40013, 40015, 40409, 40725, 41101 — to te, o które wsparcie WEEX wyraźnie prosi o otwarcie zgłoszenia. Dołącz sygnaturę czasową żądania, endpoint i zwrócony kod; to trio sprawia, że zgłoszenie jest rozwiązywalne. Pełna oficjalna referencja to lista kodów błędów API WEEX.

Co kody błędów mówią Ci o Twojej integracji

Szereguj swoje awarie według warstwy, a nie częstotliwości. Sto 429 to problem z przepustowością, który możesz dostroić w jedno popołudnie. Jeden sporadyczny 40009 to błąd podpisywania, który po cichu odrzuci zlecenia w najgorszym możliwym momencie i to jest ten, który warto naprawić najpierw. Integracje, które pozostają zdrowe w API WEEX, dzielą trzy nawyki: podpisują ponownie przy każdej próbie, nigdy nie ufają lokalnemu zegarowi i logują żądanie sieciowe, zamiast żądania, które zamierzali wysłać.

Gotowy do budowania? Utwórz i określ zakres swoich kluczy na stronie API WEEX, zacznij od klucza tylko do odczytu względem publicznych endpointów i dodaj uprawnienia do handlu dopiero, gdy Twoja lista kontrolna triage przejdzie czysto od początku do końca.

FAQ

1. Co oznacza błąd 40009 w API WEEX?

API validation failed to niezgodność podpisu znacznie częściej niż zły klucz. Odbuduj ciąg prehash jako timestamp + METHOD + requestPath + "?" + queryString + body, potwierdź, że metoda jest wielkimi literami i upewnij się, że Twoja biblioteka HTTP nie serializuje ponownie ciała JSON po podpisaniu.

2. Dlaczego moje żądanie API WEEX działa lokalnie, ale zawodzi z 40008 w produkcji?

Prawie zawsze dryf zegara hosta. Podpisana sygnatura czasowa musi mieścić się w 30 sekundach od czasu serwera WEEX, a kontenery często działają bez NTP. Zsynchronizuj zegar hosta lub zcache'uj przesunięcie z publicznego endpointu czasu serwera przy starcie.

3. Jaki jest limit stawek API WEEX?

Domyślnie jest to 10 żądań na sekundę, chyba że endpoint określa inaczej, liczone na klucz API dla wywołań uwierzytelnionych i na publiczne IP dla nieuwierzytelnionych, zgodnie z dokumentacją z 27 lipca 2026 r. Przekroczenie zwraca 429.

4. Czy mogę używać klucza API WEEX bez białej listy IP?

Tak — wsparcie WEEX sugeruje utworzenie klucza niepowiązanego z adresem IP, gdy 40018 Illegal IP request Cię blokuje. Zarezerwuj to dla kluczy tylko do odczytu. Klucz handlowy lub wypłat bez ograniczenia IP działa z dowolnego miejsca, co jest znaczącym obniżeniem bezpieczeństwa.

5. Dlaczego otrzymuję 40102 dla pary handlowej, która wyraźnie istnieje?

Prawdopodobnie wywołujesz złą domenę bazową. Żądania spot idą do https://api-spot.weex.com, a żądania kontraktów do https://api-contract.weex.com; symbol futures na hoście spot produkuje dokładnie ten błąd.

6. Czy API WEEX to to samo co framework Apache Weex?

Nie. API giełdy WEEX to interfejs handlowy REST i WebSocket. Apache Weex to wycofany framework interfejsu użytkownika mobilnego z niepowiązanymi kodami błędów, takimi jak -1001. Wyniki wyszukiwania dla "weex api" mieszają oba.

Ostrzeżenie o ryzyku

Aktywa kryptograficzne są zmienne, a handel nimi — ręcznie lub przez API Futures — może skutkować częściową lub całkowitą utratą środków. Zautomatyzowany handel dodaje tryby awarii, których handel ręczny nie ma: nieobsłużony kod błędu może pozostawić pozycje otwarte lub zduplikowane, ograniczone stawką anulowanie może zawieść, podczas gdy wypełnienie przejdzie, dryf zegara może po cichu odrzucić zlecenia redukujące ryzyko, a klucz API bez ograniczeń IP lub limitów zakresu to poświadczenie, którego atakujący może użyć z dowolnego miejsca. Handel futures na WEEX wiąże się z dźwignią, która potęguje zarówno zyski, jak i straty i może wywołać likwidację szybciej, niż bot może zareagować. Testuj z najmniejszym legalnym rozmiarem zlecenia, używaj kluczy tylko do odczytu, dopóki obsługa błędów nie zostanie udowodniona, ustaw limity pozycji i strat poza logiką handlową i nigdy nie przyznawaj uprawnień do wypłat kluczowi, który ich nie potrzebuje. Nic tutaj nie jest poradą inwestycyjną.