Expert en Spécifications OpenAPI

Guide complet pour concevoir, documenter et valider des API REST en utilisant la spécification OpenAPI (OAS 3.x).

déclencheurs:OpenAPIOASSwaggerREST APIAPI specificationvalidate openapi

Ce qu'il fait

Cette compétence permet à un agent de rédiger, lire et valider des documents de spécification OpenAPI (OAS) de qualité professionnelle. Elle fournit un cadre rigoureux pour concevoir des schémas d'API REST, garantissant la conformité aux dernières normes OAS 3.x et facilitant la génération de code client/serveur.

Quand l'utiliser

Utilisez cette compétence lorsque vous devez :

Créer une nouvelle spécification d'API à partir de zéro.
Définir des schémas de requête/réponse complexes avec JSON Schema.
Configurer des schémas de sécurité avancés, notamment OAuth2, JWT et les clés d'API.
Valider l'exactitude des définitions d'API YAML/JSON existantes.
Documenter les points de terminaison HTTP et leurs paramètres associés.

Ce qui est inclus

Références : Comprend des guides spécialisés pour la structure du document, les opérations, les schémas, les paramètres et la sécurité.
Instructions : Recettes détaillées pour le polymorphisme (oneOf), la composition (allOf) et les styles de sérialisation des paramètres.

Agents compatibles

Conçu pour les assistants de codage sensibles à la documentation tels que Claude Code, Cursor, Copilot et d'autres extensions d'IDE basées sur des LLM.

Étiquettes

#openapi #oas #rest-api #swagger #api-design #json-schema #backend

Pas encore audité

Cette compétence n'a pas encore été examinée par notre pipeline d'audit automatisé.

Informations

Dépôt: llm-code
Étoiles: 21

Compétences similaires

FastAPI Project Templates

Creates production-ready FastAPI project scaffolds with async patterns, DI, middleware, and testing best practices for high-performance APIs.

arxiv2md

Convert arXiv papers into clean, LLM-ready Markdown via a REST API or CLI for fast reading, summarization, and downstream processing.

LAP CLI

CLI for compiling, searching, and managing API specifications into a compact agent-native format and generating/installing skills from specs.

SSE Stream Resilience

Provide robust server-sent-events (SSE) stream management with Redis-backed registry, heartbeat monitoring, completion persistence, and background guardian clea

Payment Gateway Integration

Guides and code for integrating major payment providers (Stripe, PayPal, Square) with backend systems: payment intents, subscriptions, webhook handling, and PCI

ACP Checkout — MCP Binding

Guidance to expose ACP checkout REST operations as MCP tools so agents can perform commerce flows (create/update/complete/cancel checkout).

Common API Design Standards

Opinionated REST API design guidelines: HTTP semantics, status codes, URL design, versioning, pagination, and OpenAPI contract best-practices.

UXC — Unified eXecution CLI

Discover, inspect, and invoke schema-exposed remote interfaces (OpenAPI, GraphQL, gRPC, MCP, JSON-RPC) via a single CLI contract with deterministic JSON envelop

Retour aux compétences