Generator kluczy idempotencji
Generuj klucze idempotencji UUID v4 lub v7 w przeglądarce, w partiach do 100, z kopiowaniem, eksportem TXT/CSV oraz gotowymi przykładami nagłówka, cURL i fetch.
🔒 To narzędzie działa w całości w Twojej przeglądarce. Twoje pliki nigdy nie są wysyłane na serwer.
Tylko litery, cyfry, _ - . · do 32 znaków.
Wygenerowano lokalnie w Twojej przeglądarce z użyciem kryptograficznie bezpiecznej losowości. Nic nie jest przesyłane. Prefiks to tylko etykieta — nie dodaje unikalności ani bezpieczeństwa.
Zastosowanie dla programistów
Przykłady używają pierwszego wygenerowanego klucza
Wysyłaj ten sam Idempotency-Key, gdy ponawiasz tę samą operację; użyj nowego klucza dla nowej operacji. To narzędzie tylko generuje klucze — obsługę idempotencji realizuje Twoje API. Endpoint poniżej to element zastępczy, nie prawdziwa usługa.
Jak działa Generator kluczy idempotencji
- Wybierz typ klucza (UUID v4 lub v7) oraz opcjonalnie prefiks i rozmiar partii.
- Skopiuj wygenerowany klucz albo wyeksportuj partię jako TXT lub CSV.
- Wyślij go jako nagłówek Idempotency-Key; użyj tego samego klucza przy ponawianiu tej operacji, a nowego klucza przy nowej operacji.
FAQ
W czym pomaga to narzędzie?
Generuje unikalne klucze (UUID v4 lub v7, z opcjonalnym prefiksem), które dołączasz do żądania API jako nagłówek Idempotency-Key, aby bezpieczne ponowienie tej samej operacji nie zostało przetworzone dwa razy.
Czy wysyła dane gdziekolwiek?
Nie. Klucze są generowane w Twojej przeglądarce za pomocą wbudowanego, kryptograficznie bezpiecznego generatora liczb losowych i nic nie jest przesyłane.
Czy mogę użyć go od razu?
Tak. Klucz pojawia się zaraz po wczytaniu strony. Kliknij Generuj, aby uzyskać nowy, albo wybierz rozmiar partii, aby utworzyć do 100 naraz i skopiować lub wyeksportować je jako TXT lub CSV.
Czy sprawia, że moje API jest idempotentne?
Nie. Narzędzie tworzy tylko klucze. Twoje API lub dostawca płatności musi wdrożyć obsługę idempotencji, która usuwa duplikaty żądań niosących ten sam klucz.
Jaka jest różnica między UUID v4 a UUID v7?
UUID v4 jest w pełni losowy. UUID v7 osadza znacznik czasu w milisekundach przed bitami losowymi, więc klucze sortują się mniej więcej według czasu utworzenia — przydatne, gdy logujesz lub indeksujesz klucze idempotencji, ale niewymagane dla samego nagłówka.
Czy powinienem użyć tego samego klucza przy ponawianiu żądania?
Tak. Wygeneruj jeden klucz przed pierwszą próbą operacji, a następnie wysyłaj ten sam klucz przy każdym ponowieniu dokładnie tej operacji. Nowego klucza użyj tylko wtedy, gdy zaczynasz naprawdę nową operację.
Czy mogę użyć tych kluczy ze Stripe lub innymi API płatności?
Tak. Zarówno klucze UUID v4, jak i v7 działają jako wartość nagłówka Idempotency-Key u dostawców takich jak Stripe, Square oraz w większości API REST, które obsługują idempotentne zapisy.
Jak wypadamy na tle innych
| Funkcja | Online Tool Store | Ręcznie napisany fragment UUID | Generowanie kluczy po stronie serwera |
|---|---|---|---|
| Działa offline w przeglądarce | ✓ | ✓ | ✗ |
| UUID v4 i v7 | ✓ | Zależy | Zależy |
| Generowanie partii + eksport TXT/CSV | ✓ | ✗ | Czasami |
| Gotowe przykłady nagłówka, cURL i fetch | ✓ | ✗ | ✗ |
Użyj tego do szybkiego, prywatnego klucza lub partii podczas podłączania idempotentnych wywołań API; przenieś generowanie kluczy na serwer, gdy stanie się częścią Twojego procesu produkcyjnego.