Taip, OpenAPI specifikacija leidžia aprašyti API tiesiogiai YAML arba JSON formatu, kur išsamiai nurodomi keliai, metodai, parametrai, duomenų schemos ir atsakymai. Tai patogus būdas dokumentuoti ir standartizuoti API, taip pat generuoti kliento kodą ir testus. Pavyzdžiui, galima aprašyti galinį tašką taip:

paths:
  /users:
    get:
      summary: Gauti naudotojų sąrašą
      responses:
        '200':
          description: Sėkmingas atsakymas
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'

Ankstesnis Kitas