maintainx-common-errors

Umiejętność do debugowania i rozwiązywania typowych błędów API MaintainX. Użyj jej, gdy napotkasz problemy z autentykacją, błędy żądań lub nieoczekiwane odpowiedzi z API. Skill zawiera gotowe komendy diagnostyczne, mapy błędów HTTP (400, 401, 403, 404, 429, 500) oraz konkretne rozwiązania dla każdego problemu. Obsługuje weryfikację klucza API, sprawdzenie łączności, walidację pól żądania i interpretację kodów statusu. Aktywuj go frazami typu "maintainx error", "maintainx 401", "debug maintainx" lub "maintainx not working".

1. Upewnij się, że masz zainstalowany skill maintainx-common-errors w swoim środowisku Claude Code, Codex lub OpenClaw. Skill wymaga dostępu do narzędzi: Read, Write, Edit, Bash (curl) i Grep.

2. Skonfiguruj zmienną środowiskową MAINTAINX_API_KEY z Twoim kluczem API MaintainX. Upewnij się, że masz dostęp do curl, jq i logów aplikacji.

3. Gdy napotkasz błąd MaintainX, wyzwól skill używając frazy takie jak "maintainx error", "maintainx 401", "maintainx api problem", "debug maintainx" lub "maintainx not working".

4. Skill automatycznie uruchomi diagnostykę — najpierw sprawdzi poprawność klucza API (test HTTP 200), długość klucza i rozwiązanie DNS dla api.getmaintainx.com.

5. Na podstawie otrzymanego kodu błędu (400, 401, 403, 404, 429, 500) skill zaproponuje konkretne przyczyny i kroki naprawcze. Dla błędu 400 sprawdzi strukturę JSON i wymagane pola (np. title dla work orders). Dla 401 zweryfikuje ważność klucza API.

6. Postępuj według sugerowanych rozwiązań — mogą to być korekty w nagłówkach żądania, dodanie brakujących pól, zmiana wartości enumeracyjnych (priority, status) lub czekanie na reset limitów rate-limitingu.