# FAQ API
SUMMARY: Częste pytania o API — autoryzacja, limity, obsługa błędów, wykrywanie endpointów.

FAQ API
Częste pytania dotyczące API Synapse.
Jak się autoryzować?
Dwie metody:
1. Mind Key (dla endpointów danych): 
2. JWT (dla endpointów konta): 
Lub przez parametr zapytania (limit 60 żądań/min): 
Patrz Autoryzacja.
Jaka jest różnica między Mind Key a JWT?
- Mind Key: zakres dzierżawcy, nigdy nie wygasa, do danych memory/chat/tasks
- JWT: zakres użytkownika, wygasa po 7 dniach, do zarządzania kontem/umysłami
Patrz Mind Key vs JWT.
Dlaczego otrzymuję 401 Unauthorized?
Typowe przyczyny:
1. Brak nagłówka 
2. Nieprawidłowy Mind Key (zweryfikować, czy zaczyna się od )
3. Użycie JWT tam, gdzie wymagany jest Mind Key (lub odwrotnie)
4. Mind Key został cofnięty
Rozwiązanie: Zweryfikować token. Patrz Autoryzacja.
Dlaczego otrzymuję 404 Not Found?
Użyto błędnej ścieżki endpointu. Synapse ma tylko ścieżki wymienione w
.
Rozwiązanie: Wywołać , aby zobaczyć wszystkie poprawne ścieżki.
Nie zgadywać.
Dlaczego otrzymuję 429 Too Many Requests?
Używana jest autoryzacja parametrem zapytania , która ma limit 60/min.
Rozwiązanie: Przełączyć się na nagłówek  (bez limitu).
Patrz Limity żądań.
Jak wylistować wszystkie endpointy?
[CODE BLOCK]
Jak znaleźć właściwy endpoint?
1. Sprawdzić  dla listy czytelnej maszynowo
2. Sprawdzić  dla pełnej dokumentacji API
3. Przeglądać  w systemie dokumentacji
4. Użyć  dla specyfikacji OpenAPI 3.0
Czy mogę użyć GET zamiast POST?
Niektóre endpointy POST mają odpowiedniki GET dla narzędzi obsługujących tylko
URL-e:
-  ↔ 
-  ↔ 
-  ↔ 
Sprawdzić , aby zobaczyć dostępne warianty GET.
Jak obsługiwać błędy?
Wszystkie błędy zwracają JSON:
[CODE BLOCK]
Patrz Błędy i ich obsługa.
Jaki jest limit treści żądania?
10 MB. Dla większych payloadów (np. przesyłanie plików) należy użyć endpointów
multipart.
Czy API obsługuje CORS?
Tak. Wszystkie endpointy zwracają:
[CODE BLOCK]
Czy istnieje SDK?
Tak:
- Node.js: 
- MCP: 
Szczegóły w sekcji Przegląd API.
Jak paginować?
Użyć  i :
[CODE BLOCK]
Domyślny limit: 100. Maksymalny: 500.
Czy mogę filtrować wspomnienia po kategorii lub tagu?
Tak:
[CODE BLOCK]
Jak wyszukiwać wspomnienia?
Dwa sposoby:
1. Wyszukiwanie słów kluczowych FTS5: 
2. Wyszukiwanie semantyczne: 
Patrz Wyszukiwanie FTS5 i Wyszukiwanie semantyczne.
Jak zaktualizować wspomnienie?
Wykonać POST  z tym samym  +  — istniejące wspomnienie
jest aktualizowane, a nie duplikowane.
[CODE BLOCK]
Jak usunąć wspomnienie?
[CODE BLOCK]
Czy mogę usuwać masowo?
Tak:
[CODE BLOCK]
Następne kroki
- Przegląd API
- Błędy i ich obsługa
- Autoryzacja