idempotency-distributed-systems
/idempotency-distributed-systems
Zapewnia bezpieczne ponowienia w rozproszonych API płatniczych i transakcyjnych dzięki kluczom idempotentności.
- Autor
- nextboxis ↗
- Repozytorium
- library-skill-agents ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 28.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 28.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Zapewnia bezpieczne ponowienia w rozproszonych API płatniczych i transakcyjnych dzięki kluczom idempotentności.
Oryginalny opis (EN)
Use this skill when ensuring safe retries across distributed payment and transactional APIs using idempotency keys.
Jak działa
- When to use
- Prerequisites
- Step-by-step workflow
- Commands / code examples
- Common mistakes & pitfalls
- Verification checklist
- Related skills
Podgląd SKILL.md
---
name: idempotency-distributed-systems
description: Use this skill when ensuring safe retries across distributed payment and transactional APIs using idempotency keys.
---
# Idempotency in Distributed Systems
## When to use
Use this skill when you need to ensuring safe retries across distributed payment and transactional APIs using idempotency keys.
## Prerequisites
- Working knowledge of backend architecture, HTTP protocols, and systems programming.
- Appropriate runtime installed (Node.js, Python, Go, Rust, Java, or .NET depending on stack).
## Step-by-step workflow
1. **Define resource contracts**: Establish unambiguous request and response schemas, validation rules, and error envelopes.
2. **Implement routing & handlers**: Structure modular controllers or handlers keeping transport logic isolated from domain services.
3. **Enforce input validation**: Validate and sanitize all inbound parameters, headers, and payloads before reaching business logic.
4. **Implement robust error handling**: Return standardized error responses with consistent HTTP status codes and correlation IDs.
5. **Optimize resilience & telemetry**: Instrument endpoints with structured logging, health checks, metrics, and timeout boundaries.
## Commands / code examples
```ts
// Example implementation pattern for idempotency-distributed-systems
import { Request, Response, NextFunction } from 'express';
export interface StandardApiResponse<T> {
success: boolean;
data?: T;
error?: {
code: string;
message: string;
details?: unknown;
};
meta?: {
timestamp: string;
requestId: string;
};
}
export function apiResponseHandler<T>(data: T, req: Request): StandardApiResponse<T> {
return {
success: true,
data,
meta: {
timestamp: new Date().toISOString(),
requestId: (req.headers['x-request-id'] as string) || 'req_auto_gen',
},
};
}
```
## Common mistakes & pitfalls
- Exposing raw database exceptions or internal stack traces directly in client responses.
- Neglecting request timeouts, allowing hung external dependencies to exhaust server connection pools.
- Omitting correlation IDs (`X-Request-ID`), making distributed debugging impossible across microservices.
## Verification checklist
- [ ] Endpoints adhere strictly to standardized HTTP status codes and contract specifications.
- [ ] Inbound requests are validated against strict type schemas before processing.
- [ ] Errors return structured envelopes without leaking sensitive infrastructure details.
- [ ] All database queries and external service calls have explicit timeout deadlines.
## Related skills
- restful-api-design-best-practices
- api-rate-limiting-throttling
- distributed-tracing-opentelemetry-sdk
- secure-code-review-static-analysis-sast
Wersje
W bazie nie ma innych skilli o nazwie idempotency-distributed-systems.
Migawka bazy z 13.11.2026 · wersja paczki 6484eb2c0770 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100idempotency-handling
Implementuje idempotentne operacje API z kluczami idempotentności, cache w Redis i ograniczeniami w bazie danych, dla płatności, ponowień webhooków i problemów z podwójnym przetwarzaniem. - 90backend-idempotency
Wdraża klucze idempotentności, by ponowienia żądań nie powodowały podwójnych skutków, np. dwóch obciążeń tej samej płatności. - 90api-distributed-design
Projektuje kontrakty API i systemów rozproszonych z cyklu życia domeny: przepływ komunikatów, idempotentność, ponowienia i kolejki. - 90idempotency-and-retries
Zapewnia bezpieczne powtarzanie operacji: klucze idempotencji i ich przechowywanie, odpowiedź na powtórkę, ponowienia z backoffem i jitterem oraz uzgadnianie po przekroczeniu czasu z nieznanym wynikiem. - 90rs-domain-distributed
Projektuje rozwiązania rozproszone: ponowienia, limity czasu, idempotencję, sagi, blokady, zegary i gwarancje dostarczenia. - 90idempotency-and-retries
Zapewnia bezpieczne powtarzanie operacji i ponowienia: płatności, obsługa duplikatów webhooków, polityka ponowień klienta i wywołania zawodnych zależności, z gwarancją efektu dokładnie raz przy dostarczaniu co najmniej raz.