Actions: OpenAPI Spec ile API Entegrasyonu

openapi: 3.1.0
info:
  title: Weather API
  description: 2026 hava durumu servisi
  version: 1.0.0
servers:
  - url: https://api.weather.example.com
paths:
  /current:
    get:
      operationId: getCurrentWeather
      summary: Belirtilen şehir için anlık hava durumu
      parameters:
        - name: city
          in: query
          required: true
          schema:
            type: string
          description: Şehir adı (örn. "İstanbul")
        - name: units
          in: query
          required: false
          schema:
            type: string
            enum: [metric, imperial]
            default: metric
      responses:
        '200':
          description: Başarılı yanıt
          content:
            application/json:
              schema:
                type: object
                properties:
                  city: { type: string }
                  temperature: { type: number, description: "Derece (Celsius)" }
                  condition: { type: string }
                  humidity: { type: integer }
                  wind_kmh: { type: number }
        '404':
          description: Şehir bulunamadı
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key