Curs de pregatire Swagger și Specificația OpenAPI

Introducere

Definirea API

• Fișier de definiție
• Cerere API

YAML

• Ce este YAML
• Reguli ale YAML

Prezentare generală a serviciilor RESTful

• Resurse
• Transfer de stare
• Reprezentarea stării

Pregătirea mediului de dezvoltare

• Instalarea și configurarea Swagger
• Instalarea și configurarea Node.Js

Arhitectura constrângerilor serviciului web REST

• Utilizarea constrângerii client-server
• Lucrul cu constrângerile interfeței uniforme
• Lucrul cu constrângerea fără stare
• Utilizarea HTTP-caching
• Activarea unui sistem stratificat

Proiectarea API REST

• Implementarea operațiilor CRUD
• Utilizarea gestionării erorilor
• Implementarea operațiilor pentru API-uri REST
• Gestionarea schimbărilor în API
• Versionarea API
• Cache-ul API
• Suportul pentru paginare și răspunsuri parțiale

Specificații folosind Swagger

• Editarea documentelor cu Swagger
• Crearea specificațiilor în format YAML
• Crearea căilor și observațiilor
• Adăugarea documentației
• Adăugarea schemelor într-un fișier OAS
• Utilizarea SwaggerHub

Gestionarea API

• Crearea unei strategii de gestionare a API-urilor
• Gestionarea ciclului de viață al API-urilor
• Generarea de proxy-uri API
• Controlul comportamentului API-urilor
• Construirea unui portal API
• Furnizarea managementului traficului

Securitatea API

• Securizarea cu tokenuri și JWT
• Securizarea cu cheie API și secret
• Autorizare folosind OAuth2.0

Rezumat și concluzie