Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

idempotency-distributed-systems

/idempotency-distributed-systems

Zapewnia bezpieczne ponowienia w rozproszonych API płatniczych i transakcyjnych dzięki kluczom idempotentności.

Licencja
MIT
Ostatnia zmiana repozytorium
28.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. When to use
  2. Prerequisites
  3. Step-by-step workflow
  4. Commands / code examples
  5. Common mistakes & pitfalls
  6. Verification checklist
  7. Related skills
Sekcje z nagłówków SKILL.md, w oryginale · 64 linii, 322 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.