Встречается на собеседованиях • сегодня

Писал ли техническую документацию в Swagger

Да, писал техническую документацию в Swagger (OpenAPI). Использовал Swagger Editor или YAML-файлы для описания API-эндпоинтов, параметров, моделей данных и примеров ответов.

Пример описания эндпоинта в OpenAPI 3.0:

yaml
paths:
  /users/{id}:
    get:
      summary: Получить пользователя по ID
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: Успешный запрос
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string

Также интегрировал Swagger UI в Django/Flask/FastAPI для автоматической генерации документации. Например, в FastAPI:

python
from fastapi import FastAPI
app = FastAPI()

@app.get("/users/{id}", response_model=User)
async def read_user(id: int):
    return {"id": id, "name": "John Doe"}

Документация автоматически доступна по /docs или /redoc.

Sophi
Софи собрала все вопросы. Тренируйся и получай
офферы быстрее!
Попробовать бесплатноArrow

Следующий вопрос

Это единственный вопрос по вашему фильтру

как отвечать на вопрос
пример собеседования
фреймворки на собеседовании
типичные вопросы junior
интервью вопросы и ответы