Do you have experience writing specifications in Swagger or OpenAPI?

Yes, I have experience. Swagger (now OpenAPI Specification) is used to describe RESTful APIs in YAML or JSON format. The specification describes paths (endpoints), methods (GET, POST, etc.), request parameters, data structures (models), responses, and error codes. This allows for automatic generation of documentation, client SDKs, and server stubs.

Example of a simple GET request description in OpenAPI (YAML):

paths:
  /users:
    get:
      summary: Get list of users
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string