Toolverse
All skills

generating-api-sdks

by jeremylongshore

Generate client SDKs in multiple languages from OpenAPI specifications.\nUse when generating client libraries for API consumption.\nTrigger with phrases like \

Installation

Pick a client and clone the repository into its skills directory.

Installation

Quick info

Category
Backend
Views
2

About this skill

Generate client SDKs in multiple languages from OpenAPI specifications.\nUse when generating client libraries for API consumption.\nTrigger with phrases like \

How to use

  1. Przygotuj plik specyfikacji OpenAPI w formacie YAML lub JSON (wersja 3.0 lub nowsza). Upewnij się, że zawiera kompletne definicje schematów, prawidłowe odwołania ($ref) i pokrycie typów odpowiedzi dla wszystkich endpointów.

  2. Wczytaj specyfikację za pomocą narzędzia Read i zweryfikuj jej poprawność. Sprawdź, czy wszystkie operacje mają przypisane operation ID, a modele request/response są w pełni zdefiniowane.

  3. Wyodrębnij z pliku wszystkie operation ID, modele request/response oraz schematy autentykacji. Na tej podstawie będzie zbudowany katalog metod SDK.

  4. Wygeneruj typowane klasy modeli dla każdego komponentu schematu, w tym zagnieżdżone obiekty, enumy i discriminated unions z prawidłowymi adnotacjami nullable.

  5. Utwórz klasę klienta z metodami dla każdej operacji API, mapując operation ID na idiomatyczne nazwy metod w docelowym języku (np. listUsers, get_user, CreateUser).

  6. Zaimplementuj obsługę autentykacji wspierającą Bearer tokens, API keys (w nagłówkach i query) oraz OAuth2 client credentials flow. Skonfiguruj automatyczne ponowienia żądań i helpery do obsługi paginacji.

Related skills