Da, OpenAPI specifikacija omogućava opisivanje API-ja direktno u YAML ili JSON formatu, gde se detaljno navode putanje, metode, parametri, šeme podataka i odgovori. Ovo je zgodan način za dokumentovanje i standardizaciju API-ja, kao i za generisanje klijentskog koda i testova. Na primer, može se opisati endpoint ovako:

paths:
  /users:
    get:
      summary: Dobijanje liste korisnika
      responses:
        '200':
          description: Uspešan odgovor
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'

Претходно Следеће