> ## 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. # recipientId ile kayıtları listele > Belirtilen alıcı için kayıtları döndürür. ## OpenAPI ````yaml /open-api/tr/point-alarm_version-1.json get /v1/alarms/points/get-by-recipient-id/{recipientId} 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: Nokta Alarmları description: >- Nokta tabanlı şiddetli hava olayı alarmlarını kaydedin, listeleyin ve yönetin. paths: /v1/alarms/points/get-by-recipient-id/{recipientId}: get: tags: - Nokta Alarmları summary: recipientId ile kayıtları listele description: Belirtilen alıcı için kayıtları döndürür. operationId: getByRecipientId parameters: - name: recipientId in: path required: true schema: type: string minLength: 1 responses: '200': description: Alıcıya ait kayıtlar başarıyla döndürüldü content: application/json: schema: $ref: '#/components/schemas/PageRegistrationsResponse' '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' '403': description: Yasak/İzin Verilmiyor content: application/json: schema: $ref: '#/components/schemas/StandardErrorResponse' '429': description: Bu Hizmet İçin Abonelik Limitleri Aşıldı content: application/json: schema: $ref: '#/components/schemas/StandardErrorResponse' '500': description: İstek Sırasında Dahili Sunucu Hatası content: application/json: schema: $ref: '#/components/schemas/StandardErrorResponse' components: schemas: PageRegistrationsResponse: type: object properties: registrations: type: array description: Bu sayfaya ait kayıtlar items: $ref: '#/components/schemas/PointRegistration' totalRecords: type: integer format: int32 description: Toplam eşleşen kayıt sayısı example: 128 pageNumber: type: integer format: int32 description: Dönen sayfa numarası example: 0 pageSize: type: integer format: int32 description: Dönen sayfa boyutu example: 10 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 PointRegistration: type: object properties: registrationId: type: string format: uuid description: Mevcut kayıt UUID. Oluşturmada boş bırakın; güncellemede zorunlu. example: f7587d9e-2481-4b4c-818d-c8d1946851b7 recipientId: type: string description: Alıcı kimliği example: Recipient1 boundary: $ref: '#/components/schemas/Boundary' description: Alarmın mekansal sınırı (nokta+yayçap) webhook: $ref: '#/components/schemas/Webhook' description: Alarm geri çağrıları için webhook yapılandırması filter: $ref: '#/components/schemas/Filter' description: Uygulanacak olay filtreleri (yıldırım, fırtına, yağış) Boundary: type: object properties: point: $ref: '#/components/schemas/GeoPoint' description: Merkez nokta (enlem/boylam) example: lat: 39.9208 lng: 32.8541 radius: type: number format: double description: Yarıçap (mt) example: 10000 Webhook: type: object description: >-

Alarm bildirimleri için dışa çağrı (callback) yapılandırması

Bir kullanıcı hesabı adına ilk alarm kaydı oluşturulduğunda, alarm isteği ile birlikte iletilen webhook bilgisi ilgili kullanıcı hesabına bağlı olarak kaydedilir. Her hesap için yalnızca bir adet webhook tanımlanmasına izin verilir. Bu ilişkilendirme recipientId ile ilgili değildir; doğrudan servise giriş yapan kullanıcının hesabı ile ilişkilendirilir. Webhook üzerinde değişiklik yapılmak istenirse güncelleme işlemleri update servisi aracılığıyla gerçekleştirilmelidir.

İkinci ve sonraki alarm kayıtlarında webhook bilgisinin tekrar iletilmesi zorunlu değildir. Bu durumda istekte bulunan kullanıcının hesabı için daha önce tanımlanmış webhook otomatik olarak kullanılır. Webhook nesnesi içindeki accountId alanı isteğe bağlıdır; gönderilmesi halinde ilgili hesabın webhook’u kullanılır, gönderilmemesi halinde mevcut varsayılan webhook devreye alınır.

POWER_USER veya ADMIN rolüne sahip kullanıcılar, gerektiğinde başka bir hesabın accountId bilgisi kullanılarak o hesap adına alarm kaydı oluşturabilir. Ancak bu işlem, ilgili hesap için daha önce en az bir alarm kaydının oluşturulmuş ve buna bağlı olarak bir webhook kaydının sistemde mevcut olması koşuluyla mümkündür. Hedef hesap için webhook yoksa, önce webhook tanımlanmalıdır.

properties: accountId: type: string format: uuid description: >- Bu webhook’un ait olduğu hesap UUID’si (opsiyonel; varsayılan çağıran hesap). example: 2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1 url: type: string description: Bildirimlerin gönderileceği HTTPS uç noktası. example: https://api.customer.com/alerts/callback httpMethod: type: string description: Bildirim gönderilirken kullanılacak HTTP metodu. enum: - POST - PUT - GET example: POST contentType: type: string description: Gönderilecek payload’ın içerik tipi. example: application/json authentication: $ref: '#/components/schemas/AuthWrapper' description: Teslimatların güvenliği için kimlik doğrulama ayarları. requestHeaders: $ref: '#/components/schemas/MapTypeSchema' description: >- Her webhook teslimat isteğine eklenecek özel HTTP başlıkları. Format: {"Header-Name":"value","Another-Header":"value"} example: source: iklim.co custom-header: value deliveryPolicy: $ref: '#/components/schemas/DeliveryPolicy' description: Teslimat politikası (zaman aşımları ve yeniden denemeler). Filter: type: object properties: lightning: $ref: '#/components/schemas/LightningFilter' description: swagger.schema.alarms.point.filter.lightning thunderstorm: $ref: '#/components/schemas/ThunderstormFilter' description: swagger.schema.alarms.point.filter.thunderstorm precipitation: $ref: '#/components/schemas/PrecipitationFilter' description: swagger.schema.alarms.point.filter.precipitation 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 AuthWrapper: description: Discriminator alanı "type" olan kimlik doğrulama zarfı. discriminator: propertyName: type mapping: BASIC: $ref: '#/components/schemas/BasicAuthentication' JWT_TOKEN: $ref: '#/components/schemas/JwtAuthentication' API_KEY: $ref: '#/components/schemas/ApiKeyAuthentication' HMAC_SIGNATURE: $ref: '#/components/schemas/HmacAuthentication' oneOf: - $ref: '#/components/schemas/BasicAuthentication' - $ref: '#/components/schemas/JwtAuthentication' - $ref: '#/components/schemas/ApiKeyAuthentication' - $ref: '#/components/schemas/HmacAuthentication' MapTypeSchema: type: object example: key-1: value-1 key-2: value-2 properties: key: type: string example: key-1 value: type: string example: value-1 DeliveryPolicy: type: object description: Teslimat zaman aşımı ve yeniden deneme davranışı. properties: timeout: type: integer format: int64 description: İstek zaman aşımı (saniye). example: 60 maxRetries: type: integer format: int32 description: Azami yeniden deneme sayısı. example: 3 retryDelay: type: integer format: int32 description: Yeniden denemeler arası bekleme (saniye). example: 10 LightningFilter: type: object description: Yıldırım olayı filtresi properties: type: type: string description: Yıldırım olay tipi enum: - FLASH_CLOUD_TO_GROUND - PULSE_IN_CLOUD example: FLASH_CLOUD_TO_GROUND peakCurrent: type: number format: double description: Tepe akım (Amp, CG darbeleri genelde negatiftir) example: -12.5 inCloudHeight: type: number format: double description: Bulut içi boşalma yüksekliği (metre) example: 4500 ThunderstormFilter: type: object description: Fırtına (gök gürültülü sağanak) olayı filtresi properties: intersectsAffectedPolygon: type: boolean description: Olay etkilenen alan poligonu kaydedilen poligon ile kesişmeli example: true intersectsCellPolygon: type: boolean description: Olay hücre poligonu kaydedilen poligon ile kesişmeli example: false severityThreshold: type: string description: Asgari şiddet eşiği enum: - LOW - MEDIUM - HIGH example: MEDIUM speedThreshold: type: number format: double description: Asgari fırtına hızı (km/sa) example: 20 PrecipitationFilter: type: object description: Yağış olayı filtresi properties: intensities: type: array description: İzin verilen yağış şiddetleri example: - LIGHT - MODERATE items: type: string enum: - DRIZZLE - LIGHT - MODERATE - HEAVY - VERY_HEAVY - EXTREME BasicAuthentication: type: object description: HTTP Basic kimlik doğrulama. properties: type: type: string description: Kimlik doğrulama tipini belirleyen alan. enum: - BASIC - JWT_TOKEN - API_KEY - HMAC_SIGNATURE example: API_KEY writeOnly: true username: type: string description: Basic kimlik doğrulama kullanıcı adı. example: alert-user password: type: string description: Basic kimlik doğrulama parolası. example: '******' JwtAuthentication: type: object description: Bearer JWT belirteci ile kimlik doğrulama. properties: type: type: string description: Kimlik doğrulama tipini belirleyen alan. enum: - BASIC - JWT_TOKEN - API_KEY - HMAC_SIGNATURE example: API_KEY writeOnly: true jwtToken: type: string description: Authorization başlığında gönderilecek JWT belirteci. example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.... ApiKeyAuthentication: type: object description: API anahtarı ile kimlik doğrulama (header ve/veya query). properties: type: type: string description: Kimlik doğrulama tipini belirleyen alan. enum: - BASIC - JWT_TOKEN - API_KEY - HMAC_SIGNATURE example: API_KEY writeOnly: true apiKey: type: string description: İstekle gönderilecek API anahtarı değeri. example: x-1234567890abcdef asQueryParameter: type: boolean description: Doğru ise API anahtarı query parametresi olarak gönderilir. example: false asHeader: type: boolean description: Doğru ise API anahtarı istek başlığında gönderilir. example: true HmacAuthentication: type: object description: ClientId/secret ile HMAC imzalı kimlik doğrulama. properties: type: type: string description: Kimlik doğrulama tipini belirleyen alan. enum: - BASIC - JWT_TOKEN - API_KEY - HMAC_SIGNATURE example: API_KEY writeOnly: true clientId: type: string description: İmza girdisinde kullanılan istemci kimliği. example: bem-portal secret: type: string description: HMAC hesaplaması için paylaşılan gizli anahtar. example: '******' algorithm: type: string description: Kullanılacak HMAC algoritması. enum: - HmacSHA1 - HmacSHA256 - HmacSHA384 - HmacSHA512 - HmacMD5 example: HmacSHA256 ````