Rozwiązywanie problemów

Znajdź ID żądania

W ustawieniach API otwórz Historię żądań. Filtruj po kluczu i wyniku. Domyślnie zobaczysz ostatnie 7 dni, metodę, kod HTTP, kod błędu i czas wykonania. Panel nie wyświetla payloadów, e-maili ani sekretów.

requestId w błędzie odpowiada nagłówkowi X-Request-Id. Brak wpisu nie dowodzi braku wykonania: żądanie bez rozpoznanego klucza może nie trafić do historii, a awaria zapisu historii może pozostawić luki.

Kody błędów

HTTP	Kod	Co zrobić
400	INVALID_JSON	Popraw składnię JSON. Użyj serializerów zamiast składania tekstu.
400	INVALID_CURSOR	Zacznij stronicowanie od początku i użyj zwróconego nextAfterId.
401	UNAUTHORIZED	Sprawdź nagłówek Bearer, sekret i czy klucz nie jest unieważniony.
403	ACCOUNT_SUSPENDED	Sprawdź stan usług konta w Apresly lub skontaktuj się z pomocą.
404	CAMPAIGN_NOT_FOUND	Sprawdź ID i konto klucza, pobierz listę kampanii.
404	LEAD_NOT_FOUND	E-mail nie ma rejestracji w tej kampanii. Sprawdź pisownię, wielkość liter i aliasy.
404	NOT_FOUND	Sprawdź ścieżkę i metodę żądania.
409	CAMPAIGN_NOT_PUBLISHED	Opublikuj kampanię przed rejestracją.
413	PAYLOAD_TOO_LARGE	Zmniejsz JSON do maks. 16 KiB.
415	UNSUPPORTED_MEDIA_TYPE	Ustaw Content-Type: application/json.
422	VALIDATION_ERROR	Sprawdź email, language, ID, limity i dodatkowe pola lub parametry.
429	RATE_LIMITED	Odczekaj Retry-After sekund. Limit konta jest wspólny dla kluczy.
500	INTERNAL_ERROR	Spróbuj później. Jeśli błąd wraca, przekaż requestId do pomocy.
503	SERVICE_UNAVAILABLE	Ponów z rosnącym opóźnieniem i ograniczoną liczbą prób.

Ostrzeżenia w udanej odpowiedzi

Rejestracja może się udać bez linków, terminu lub licznika. Ostrzeżenia nie są kodami HTTP: sprawdzaj warnings także po 200 i 201.

Ostrzeżenie	Co oznacza i co sprawdzić
CAMPAIGN_NOT_PUBLISHED	Lookup historycznego leada w szkicu. Opublikuj kampanię, żeby otrzymywać linki i licznik.
COUNTDOWN_TOOLS_UNAVAILABLE	Konto nie ma obecnie dostępnych narzędzi licznika. Sprawdź uprawnienia planu. API pozostaje dostępne, ale linki i licznik są puste.
NO_OFFER_PAGES	Brak kwalifikujących się stron oferty w kampanii. Skonfiguruj strony, a potem wykonaj lookup.
NO_MAIL_TIMER	Kampania nie ma skonfigurowanego licznika mailowego. Skonfiguruj go, jeśli chcesz obraz w e-mailu.
NO_DEADLINE	Mechanizm kampanii nie ustalił terminu. Sprawdź typ kampanii, reguły aktywacji i ustawienia licznika.

Termin jest null lub już wygasł

Lookup odczytuje aktualny stan i nie odnawia oferty. Może więc zwrócić stary termin. Przed przypomnieniem porównaj datę UTC z aktualnym czasem. timeZone opisuje konfigurację kampanii, nie zmienia formatu daty UTC w deadline.

Przy null nie wymyślaj własnego terminu. Sprawdź NO_DEADLINE i zasady kampanii. Nie wysyłaj pola deadline w rejestracji, API je odrzuci.

Rejestracja nie wysłała e-maila

To oczekiwane: API zwraca dane oferty. Twoja platforma mailowa lub automatyzacja musi wysłać wiadomość. Zmapuj offerLinks[].url do przycisku, a opcjonalne mailTimerUrl do obrazu. Do egzekwowania wygaśnięcia na stronie nadal potrzebujesz widgetu Apresly.

Utracona odpowiedź lub podwójny e-mail

Timeout nie oznacza wycofania transakcji. Pierwsza rejestracja mogła się udać. Odczytaj stan przez lookup, a wysyłkę deduplikuj według zdarzenia w swoim systemie. created: false może wystąpić po udanej pierwszej rejestracji, a created: true nie zastępuje potwierdzenia dostawy e-maila.

Zmiana klucza i kontakt z pomocą

Aby wymienić klucz, utwórz nowy, zaktualizuj integrację i dopiero po sprawdzeniu unieważnij poprzedni. Inne klucze nadal działają. Wcześniej otrzymane linki do ofert pozostają ważne według zasad kampanii.

Napisz do [email protected]. Dołącz metodę, endpoint, kod HTTP, kod błędu, czas wystąpienia i requestId. Nie wysyłaj sekretu ani danych klientów. Zrzuty ekranu również oczyść z tych informacji.