> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.iklim.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Fırtına Detayı Getir

> Belirli bir fırtına olayına ait detaylı geçmiş bilgileri döner.



## OpenAPI

````yaml /open-api/tr/thunderstorms_version-1.json post /v1/thunderstorms/get
openapi: 3.1.0
info:
  title: OpenAPI definition
  version: v0
servers:
  - url: https://api.iklim.co
    description: Production server
  - url: https://api-test.iklim.co
    description: Test server
security: []
tags:
  - name: Fırtına Hizmeti
    description: Fırtına ve Şiddetli hava olayları ile ilgili hizmetleri yönetir
paths:
  /v1/thunderstorms/get:
    post:
      tags:
        - Fırtına Hizmeti
      summary: Fırtına Detayı Getir
      description: Belirli bir fırtına olayına ait detaylı geçmiş bilgileri döner.
      operationId: getByEventId
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ThunderstormsEventRequest'
        required: true
      responses:
        '200':
          description: Fırtına detayları başarıyla döndü.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThunderstormsResponse'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '402':
          description: Ücretli Abonelik Gerekli
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Payment Required:
                  summary: Example response
                  description: Payment Required
                  value:
                    timestamp: '2025-06-25T11:15:41.429518242'
                    status: 402
                    error: Payment Required
                    message: You Need To Renew Your Subscription or Purchase New One
                    path: /v1/thunderstorms/get
        '403':
          description: Yasak/İzin Verilmiyor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                No Subscription Found For This Service Endpoint:
                  summary: Missing Subscription
                  description: No Subscription Found For This Service Endpoint
                  value:
                    timestamp: '2025-06-25T11:21:50.510755746'
                    status: 403
                    error: Forbidden
                    message: No Subscription Found For This Service Endpoint
                    path: /v1/thunderstorms/get
                This Location Is Not In Allowed Geographic Boundaries:
                  summary: Out of Allowed Geographic Boundaries
                  description: This Location Is Not In Allowed Geographic Boundaries
                  value:
                    timestamp: '2025-06-25T15:59:19.452326857'
                    status: 403
                    error: Forbidden
                    message: >-
                      The Location You Are Querying [dd.ddddd, dd.ddddd] Is Not
                      Within The Geographic Boundaries Allowed In Your
                      Subscription [Country, Region]
                    path: /v1/thunderstorms/get
        '429':
          description: Bu Hizmet İçin Abonelik Limitleri Aşıldı
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Too Many Requests:
                  summary: Example response
                  description: Too Many Requests
                  value:
                    timestamp: '2025-06-25T11:02:12.653874655'
                    status: 429
                    error: Too Many Requests
                    message: Your Subscription Limits For This Service is Exceeded
                    path: /v1/thunderstorms/get
        '500':
          description: İstek Sırasında Dahili Sunucu Hatası
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Internal Server Error Example:
                  summary: Example response
                  description: Internal Server Error Example
                  value:
                    timestamp: '2025-04-14T16:58:10.414972912'
                    status: 500
                    error: Internal Server Error
                    message: An Error Occurred During Invocation
                    path: /endpoint/uri/here
components:
  schemas:
    ThunderstormsEventRequest:
      type: object
      properties:
        eventId:
          type: string
          description: Yıldırım olayı kimliği.
          example: EVT20240413001
          minLength: 1
        pageNumber:
          type: integer
          format: int32
          description: Sayfalama için sayfa numarası.
          example: 0
          minimum: 0
        pageSize:
          type: integer
          format: int32
          description: Sayfalama için sayfa boyutu.
          example: 10
          maximum: 100
      required:
        - eventId
        - pageNumber
        - pageSize
    ThunderstormsResponse:
      type: object
      properties:
        thunderstorms:
          type: array
          description: Yıldırım olay listesi.
          items:
            $ref: '#/components/schemas/Thunderstorm'
        totalRecords:
          type: integer
          format: int32
          description: Toplam kayıt sayısı.
          example: 100
        pageNumber:
          type: integer
          format: int32
          description: Sayfa numarası.
          example: 0
        pageSize:
          type: integer
          format: int32
          description: Sayfa boyutu.
          example: 10
      required:
        - pageNumber
        - pageSize
        - thunderstorms
        - totalRecords
    StandardErrorResponse:
      type: object
      description: Standart API hata cevabı yapısı
      properties:
        timestamp:
          type: string
          format: date-time
          description: Hatanın oluştuğu zaman damgası
          example: YYYY-mm-DDTHH:MM:SS.nnnnnnnnn
        status:
          type: integer
          format: int32
          description: HTTP durum kodu
          example: XXX
        error:
          type: string
          description: Hata adı veya tipi
          example: Error Name
          minLength: 1
        message:
          type: string
          description: Ana hata mesajı
          example: Error Message
          minLength: 1
        messages:
          type: array
          description: Ek detaylı hata mesajları
          items:
            type: string
        path:
          type: string
          description: Hatanın oluştuğu istek yolu
          example: /endpoint/uri/here
          minLength: 1
      required:
        - error
        - message
        - path
        - status
        - timestamp
    Thunderstorm:
      type: object
      properties:
        eventId:
          type: string
          description: Yıldırım olayı kimliği.
          example: EVT20240413001
        insertedAtEpoch:
          type: integer
          format: int64
          description: Eklenme zamanı (epoch ms).
          example: 1746454091000
        eventStartUtcEpoch:
          type: integer
          format: int64
          description: Olay başlangıç zamanı (epoch ms).
          example: 1746453091000
        eventEndUtcEpoch:
          type: integer
          format: int64
          description: Olay bitiş zamanı (epoch ms).
          example: 1746454091000
        severity:
          type: string
          description: Olay şiddeti.
          example: Low/Normal/High
        threshold:
          type: integer
          format: int32
          description: Sınıflandırma eşik değeri.
          example: 7
        meta:
          $ref: '#/components/schemas/Meta'
          description: Meta bilgileri.
        cell:
          $ref: '#/components/schemas/CellInfo'
          description: Hücre bilgileri.
        threatPolygon:
          $ref: '#/components/schemas/GeoPolygon'
          description: Fırtınadan etkilenmesi öngörülen tehdit sahasını gösteren poligon.
    Meta:
      type: object
      properties:
        country:
          type: string
          description: Olayın gerçekleştiği ülke.
          example: Türkiye
        state:
          type: string
          description: Olayın gerçekleştiği il/bölge.
          example: Ankara
        city:
          type: string
          description: Olayın gerçekleştiği ilçe/şehir.
          example: Çankaya
        speedUnit:
          type: string
          description: Hız birimi.
          example: mph
        speed:
          type: number
          format: float
          description: Hücrenin hızı (seçili birimde).
          example: 35.4
    CellInfo:
      type: object
      properties:
        area:
          type: number
          format: double
          description: Hücre alanı (km²).
          example: 23.5
        speed:
          type: number
          format: double
          description: Hücre hızı.
          example: 44.8
        direction:
          type: integer
          format: int32
          description: Hareket yönü (derece).
          example: 270
        flashRates:
          $ref: '#/components/schemas/FlashRates'
          description: Yıldırım hızı bilgileri.
        centroid:
          $ref: '#/components/schemas/GeoPoint'
          description: Hücre merkezi.
        polygon:
          $ref: '#/components/schemas/GeoPolygon'
          description: Fırtınanın etki alanını temsil eden poligon.
    GeoPolygon:
      type: object
      properties:
        exterior:
          type: array
          description: Poligonun dış halkasını tanımlayan GeoPoint listesi.
          example:
            - lng: 32.85
              lat: 39.93
            - lng: 32.86
              lat: 39.93
            - lng: 32.86
              lat: 39.94
            - lng: 32.85
              lat: 39.94
            - lng: 32.85
              lat: 39.93
          items:
            $ref: '#/components/schemas/GeoPoint'
        holes:
          type: array
          description: >-
            İç halkaların (deliklerin) listesi. Her delik kendi GeoPoint listesi
            ile tanımlanır. Boş veya null olabilir.
          example:
            - - lng: 32.852
                lat: 39.932
              - lng: 32.853
                lat: 39.932
              - lng: 32.853
                lat: 39.933
              - lng: 32.852
                lat: 39.933
              - lng: 32.852
                lat: 39.932
          items:
            type: array
            items:
              $ref: '#/components/schemas/GeoPoint'
      required:
        - exterior
    FlashRates:
      type: object
      properties:
        inCloud:
          type: number
          format: double
          description: Bulut içi yıldırımlar (dakika başına).
          example: 1.3
        cloudToGround:
          type: number
          format: double
          description: Buluttan yere yıldırımlar (dakika başına).
          example: 0.8
        total:
          type: number
          format: double
          description: Toplam yıldırım (dakika başına).
          example: 2.1
    GeoPoint:
      type: object
      properties:
        lng:
          type: number
          format: double
          description: Boylam koordinatı.
          example: 32.857358
          maximum: 180
          minimum: -180
        lat:
          type: number
          format: double
          description: Enlem koordinatı.
          example: 39.93504
          maximum: 90
          minimum: -90
      required:
        - lat
        - lng

````