> ## 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.

# Alıcı kimliği ile getir

> Belirtilen alıcı kimliğiyle ilişkili kayıtların listesi. Alıcı kimliği tekil ve US-ASCII karakter setine uygun olmalıdır.



## OpenAPI

````yaml /open-api/tr/geo-alarm_version-1.json get /v1/alarms/geometries/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: Coğrafi Alarm Kayıtları
    description: >-
      Şehir/ilçe/mahalle veya özel alanlarda doğa olayları için kayıt ve sorgu
      uçları
paths:
  /v1/alarms/geometries/get-by-recipient-id/{recipientId}:
    get:
      tags:
        - Coğrafi Alarm Kayıtları
      summary: Alıcı kimliği ile getir
      description: >-
        Belirtilen alıcı kimliğiyle ilişkili kayıtların listesi. Alıcı kimliği
        tekil ve US-ASCII karakter setine uygun olmalıdır.
      operationId: getByRecipientId
      parameters:
        - name: recipientId
          in: path
          description: >-
            Alıcı kimliği. Alıcı kimliği tekil ve US-ASCII karakter setine uygun
            olmalıdır.
          required: true
          schema:
            type: string
          example: Ankara
      responses:
        '200':
          description: İşlem başarılı
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PageRegistrationsResponse'
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
components:
  schemas:
    PageRegistrationsResponse:
      type: object
      description: Alarm kayıtlarının sayfalandırılmış sonuç kümesi.
      properties:
        registrations:
          type: array
          description: Kayıt listesi
          items:
            $ref: '#/components/schemas/GeoRegistration'
        totalRecords:
          type: integer
          format: int32
          description: Toplam kayıt
          example: 123
        pageNumber:
          type: integer
          format: int32
          description: Mevcut sayfa numarası
          example: 0
        pageSize:
          type: integer
          format: int32
          description: 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
    GeoRegistration:
      type: object
      description: Kayıt gövdesi (sınır, webhook ve filtreler)
      properties:
        registrationId:
          type: string
          format: uuid
          description: Kayıt UUID
          example: f7587d9e-2481-4b4c-818d-c8d1946851b7
        recipientId:
          type: string
          description: >-
            Alıcı kimliği. Alıcı kimliği tekil ve US-ASCII karakter setine uygun
            olmalıdır.
          example: Recipient 1
        boundary:
          $ref: '#/components/schemas/BoundarySchemaWrapper'
        webhook:
          $ref: '#/components/schemas/Webhook'
          description: Webhook yapılandırması
        filter:
          $ref: '#/components/schemas/GeoFilter'
          description: Alarm filtreleri
    BoundarySchemaWrapper:
      description: >-
        <section><h3>Alarm kayıt sınırı</h3><p>Alarm koşulları için izlenecek
        coğrafi kapsamı tanımlar. Somut sınır türü <code>type</code> ayırt edici
        alanı ile seçilir; yalnızca seçilen alt türe ait alanlar
        gönderilmelidir.</p><ul><li><strong>ADMINISTRATIVE</strong> – il
        (<code>cityId</code>), ilçe (<code>districtId</code>) ve isteğe bağlı
        mahalle (<code>neighborhoodId</code>) ile tanımlanan idari
        sınır.</li><li><strong>POLYGON</strong> – dış halka koordinatlarıyla
        (WGS84) tanımlanan serbest kapalı
        poligon.</li><li><strong>H3INDEX</strong> – tek bir Uber H3 hücre
        adresiyle tanımlanan sınır.</li></ul></section>
      discriminator:
        propertyName: type
        mapping:
          ADMINISTRATIVE:
            $ref: '#/components/schemas/RegisterAdministrativeBoundary'
          POLYGON:
            $ref: '#/components/schemas/RegisterPolygonBoundary'
          H3INDEX:
            $ref: '#/components/schemas/RegisterH3IndexBoundary'
      oneOf:
        - $ref: '#/components/schemas/RegisterAdministrativeBoundary'
        - $ref: '#/components/schemas/RegisterPolygonBoundary'
        - $ref: '#/components/schemas/RegisterH3IndexBoundary'
    Webhook:
      type: object
      description: >-
        <section><h3>Alarm bildirimleri için dışa çağrı (callback)
        yapılandırması</h3><p>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
        <em>recipientId</em> 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 <code>update</code> servisi
        aracılığıyla gerçekleştirilmelidir.</p><p>İ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
        <code>accountId</code> 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.</p><p><code>POWER_USER</code> veya
        <code>ADMIN</code> rolüne sahip kullanıcılar, gerektiğinde başka bir
        hesabın <code>accountId</code> 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.</p></section>
      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).
    GeoFilter:
      type: object
      description: swagger.schema.filter
      properties:
        lightning:
          $ref: '#/components/schemas/LightningFilter'
          description: Yıldırım filtresi
        thunderstorm:
          $ref: '#/components/schemas/ThunderstormFilter'
          description: Fırtına filtresi
        precipitation:
          $ref: '#/components/schemas/PrecipitationFilter'
          description: Yağış filtresi
    RegisterAdministrativeBoundary:
      type: object
      description: İdari sınır (şehir/ilçe/mahalle)
      properties:
        type:
          type: string
          enum:
            - ADMINISTRATIVE
            - POLYGON
            - H3INDEX
          writeOnly: true
        cityId:
          type: integer
          format: int64
          description: Şehir ID
          example: 6
        districtId:
          type: integer
          format: int64
          description: İlçe ID
          example: 557
        neighborhoodId:
          type: integer
          format: int64
          description: Mahalle ID
          example: 55766
      required:
        - cityId
    RegisterPolygonBoundary:
      type: object
      description: swagger.schema.boundary.polygon
      properties:
        type:
          type: string
          enum:
            - ADMINISTRATIVE
            - POLYGON
            - H3INDEX
          writeOnly: true
        polygon:
          $ref: '#/components/schemas/GeoPolygon'
          description: GeoPolygon nesnesi (WGS84)
    RegisterH3IndexBoundary:
      type: object
      description: swagger.schema.boundary.h3
      properties:
        type:
          type: string
          enum:
            - ADMINISTRATIVE
            - POLYGON
            - H3INDEX
          writeOnly: true
        h3Address:
          type: string
          description: Tekil H3 adresi. Onaltılık dize olarak temsil edilir.
          example: 8928308280fffff
    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
    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
    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
    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

````