Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

api-pagination-filtering-sorting

/api-pagination-filtering-sorting

Projektuje stronicowanie kursorowe i offsetowe, dynamiczne filtry oraz sortowanie wielopolowe w REST API.

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

Projektuje stronicowanie kursorowe i offsetowe, dynamiczne filtry oraz sortowanie wielopolowe w REST API.

Oryginalny opis (EN)

Use this skill when designing cursor-based pagination, offset pagination, dynamic filters, and multi-field sorting on REST APIs.

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, 324 słów
Podgląd SKILL.md
---
name: api-pagination-filtering-sorting
description: Use this skill when designing cursor-based pagination, offset pagination, dynamic filters, and multi-field sorting on REST APIs.
---
# API Pagination, Filtering & Sorting

## When to use
Use this skill when you need to designing cursor-based pagination, offset pagination, dynamic filters, and multi-field sorting on REST APIs.

## 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 api-pagination-filtering-sorting
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

RepozytoriumWynikLicencja
Ta strona · nextboxis/library-skill-agents100MIT
ajyadav013/claude-kit100MIT

Migawka bazy z 13.11.2026 · wersja paczki dbf55a5a2f71 (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

  • 100response-design-and-pagination
    Projektuje formaty odpowiedzi API i stronicowanie kursorowe, offsetowe lub keyset, z kopertami list i rozszerzaniem obiektów.
  • 100pagination
    Opisuje wzorce paginacji API: offsetową, kursorową i keyset, wraz z filtrowaniem, sortowaniem i metadanymi stron, w implementacjach REST i GraphQL.
  • 100pagination-and-filtering
    Wprowadza stronicowanie, sortowanie, filtrowanie i wyszukiwanie list, tak by wynik był stabilny przy równoległych zapisach, ograniczony kosztowo i zgodny z konwencjami repozytorium.
  • 90Linear Pagination + Filtering
    Pobiera duże zbiory wyników z Linear: paginacja kursorowa, DSL filtrów, sortowanie i budżetowanie złożoności.
  • 100api-design
    Projektuje lub przegląda REST API: nazwy zasobów, kody statusu, stronicowanie, filtrowanie, błędy, wersjonowanie i limity.
  • 100search-and-pagination-scoping
    Sprawdza, czy wyszukiwanie, sortowanie i stronicowanie kursorem nie pokazują danych spoza zakresu użytkownika.

Uwagi i zgłoszenia

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