> ## 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 Listesi (Yarıçap İçinde) > Merkez noktaya belirli bir yarıçap içindeki fırtınaların sayfalı listesini döner. Bu uç nokta, verilen nokta için en fazla 50 km çap ve endTimeEpoch değerine bağlı 30 gün aralığında veri sorgulamaya izin verir. ## OpenAPI ````yaml /open-api/tr/thunderstorms_version-1.json post /v1/thunderstorms/within 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/within: post: tags: - Fırtına Hizmeti summary: Fırtına Listesi (Yarıçap İçinde) description: >- Merkez noktaya belirli bir yarıçap içindeki fırtınaların sayfalı listesini döner. Bu uç nokta, verilen nokta için en fazla 50 km çap ve endTimeEpoch değerine bağlı 30 gün aralığında veri sorgulamaya izin verir. operationId: getWithin requestBody: content: application/json: schema: $ref: '#/components/schemas/ThunderstormsWithinRequest' required: true responses: '200': description: Yarıçap içindeki fırtına listesi 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/page '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/page 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/page '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/page '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: ThunderstormsWithinRequest: type: object properties: latitude: type: number format: double description: Merkez noktanın enlemi. example: 39.869847 maximum: 90 minimum: -90 longitude: type: number format: double description: Merkez noktanın boylamı. example: 32.745468 maximum: 180 minimum: -180 radius: type: number format: double description: Metre cinsinden arama yarıçapı. example: 1000 maximum: 50000 minimum: 0 backwardInterval: type: integer format: int64 description: Sorgu aralığı (bitiş zamanından geriye, saniye cinsinden). example: 600 maximum: 2592000 minimum: 60 endTimeEpoch: type: integer format: int64 description: Sorgunun bitiş zamanı (epoch milisaniye). example: 1746454091000 minimum: 0 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 intersectsWith: type: string description: >- Hangi poligonla kesişim yapılacağını belirtir. Değerler: AFFECTED_POLYGON, CELL_POLYGON. enum: - THREAT_POLYGON - CELL_POLYGON example: AFFECTED_POLYGON required: - backwardInterval - endTimeEpoch - latitude - longitude - pageNumber - pageSize - radius 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 ````