Közvetlenül az OpenAPI-specifikációban írja le?

Igen, az OpenAPI specifikáció lehetővé teszi az API közvetlen leírását YAML vagy JSON formátumban, ahol részletesen megadjuk az útvonalakat, módszereket, paramétereket, adat sémákat és válaszokat. Ez kényelmes módja az API dokumentálásának és szabványosításának, valamint klienskód és tesztek generálásának. Például így írhatunk le egy végpontot:

paths:
  /users:
    get:
      summary: Felhasználók listájának lekérése
      responses:
        '200':
          description: Sikeres válasz
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'