Ana içeriğe atla
POST
/
v1
/
alarms
/
points
/
register
Nokta alarm kaydı oluştur
curl --request POST \
  --url https://api.iklim.co/v1/alarms/points/register \
  --header 'Content-Type: application/json' \
  --data '
{
  "registrationId": "f7587d9e-2481-4b4c-818d-c8d1946851b7",
  "recipientId": "Recipient1",
  "boundary": {
    "point": {
      "lat": 39.9208,
      "lng": 32.8541
    },
    "radius": 10000
  },
  "webhook": {
    "accountId": "2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1",
    "url": "https://api.customer.com/alerts/callback",
    "httpMethod": "POST",
    "contentType": "application/json",
    "authentication": {
      "type": "API_KEY",
      "username": "alert-user",
      "password": "******"
    },
    "requestHeaders": {
      "source": "iklim.co",
      "custom-header": "value"
    },
    "deliveryPolicy": {
      "timeout": 60,
      "maxRetries": 3,
      "retryDelay": 10
    }
  },
  "filter": {
    "lightning": {
      "type": "FLASH_CLOUD_TO_GROUND",
      "peakCurrent": -12.5,
      "inCloudHeight": 4500
    },
    "thunderstorm": {
      "intersectsAffectedPolygon": true,
      "intersectsCellPolygon": false,
      "severityThreshold": "MEDIUM",
      "speedThreshold": 20
    },
    "precipitation": {
      "intensities": [
        "LIGHT",
        "MODERATE"
      ]
    }
  }
}
'
import requests

url = "https://api.iklim.co/v1/alarms/points/register"

payload = {
    "registrationId": "f7587d9e-2481-4b4c-818d-c8d1946851b7",
    "recipientId": "Recipient1",
    "boundary": {
        "point": {
            "lat": 39.9208,
            "lng": 32.8541
        },
        "radius": 10000
    },
    "webhook": {
        "accountId": "2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1",
        "url": "https://api.customer.com/alerts/callback",
        "httpMethod": "POST",
        "contentType": "application/json",
        "authentication": {
            "type": "API_KEY",
            "username": "alert-user",
            "password": "******"
        },
        "requestHeaders": {
            "source": "iklim.co",
            "custom-header": "value"
        },
        "deliveryPolicy": {
            "timeout": 60,
            "maxRetries": 3,
            "retryDelay": 10
        }
    },
    "filter": {
        "lightning": {
            "type": "FLASH_CLOUD_TO_GROUND",
            "peakCurrent": -12.5,
            "inCloudHeight": 4500
        },
        "thunderstorm": {
            "intersectsAffectedPolygon": True,
            "intersectsCellPolygon": False,
            "severityThreshold": "MEDIUM",
            "speedThreshold": 20
        },
        "precipitation": { "intensities": ["LIGHT", "MODERATE"] }
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    registrationId: 'f7587d9e-2481-4b4c-818d-c8d1946851b7',
    recipientId: 'Recipient1',
    boundary: {point: {lat: 39.9208, lng: 32.8541}, radius: 10000},
    webhook: {
      accountId: '2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1',
      url: 'https://api.customer.com/alerts/callback',
      httpMethod: 'POST',
      contentType: 'application/json',
      authentication: {type: 'API_KEY', username: 'alert-user', password: '******'},
      requestHeaders: {source: 'iklim.co', 'custom-header': 'value'},
      deliveryPolicy: {timeout: 60, maxRetries: 3, retryDelay: 10}
    },
    filter: {
      lightning: {type: 'FLASH_CLOUD_TO_GROUND', peakCurrent: -12.5, inCloudHeight: 4500},
      thunderstorm: {
        intersectsAffectedPolygon: true,
        intersectsCellPolygon: false,
        severityThreshold: 'MEDIUM',
        speedThreshold: 20
      },
      precipitation: {intensities: ['LIGHT', 'MODERATE']}
    }
  })
};

fetch('https://api.iklim.co/v1/alarms/points/register', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.iklim.co/v1/alarms/points/register",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'registrationId' => 'f7587d9e-2481-4b4c-818d-c8d1946851b7',
    'recipientId' => 'Recipient1',
    'boundary' => [
        'point' => [
                'lat' => 39.9208,
                'lng' => 32.8541
        ],
        'radius' => 10000
    ],
    'webhook' => [
        'accountId' => '2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1',
        'url' => 'https://api.customer.com/alerts/callback',
        'httpMethod' => 'POST',
        'contentType' => 'application/json',
        'authentication' => [
                'type' => 'API_KEY',
                'username' => 'alert-user',
                'password' => '******'
        ],
        'requestHeaders' => [
                'source' => 'iklim.co',
                'custom-header' => 'value'
        ],
        'deliveryPolicy' => [
                'timeout' => 60,
                'maxRetries' => 3,
                'retryDelay' => 10
        ]
    ],
    'filter' => [
        'lightning' => [
                'type' => 'FLASH_CLOUD_TO_GROUND',
                'peakCurrent' => -12.5,
                'inCloudHeight' => 4500
        ],
        'thunderstorm' => [
                'intersectsAffectedPolygon' => true,
                'intersectsCellPolygon' => false,
                'severityThreshold' => 'MEDIUM',
                'speedThreshold' => 20
        ],
        'precipitation' => [
                'intensities' => [
                                'LIGHT',
                                'MODERATE'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.iklim.co/v1/alarms/points/register"

	payload := strings.NewReader("{\n  \"registrationId\": \"f7587d9e-2481-4b4c-818d-c8d1946851b7\",\n  \"recipientId\": \"Recipient1\",\n  \"boundary\": {\n    \"point\": {\n      \"lat\": 39.9208,\n      \"lng\": 32.8541\n    },\n    \"radius\": 10000\n  },\n  \"webhook\": {\n    \"accountId\": \"2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1\",\n    \"url\": \"https://api.customer.com/alerts/callback\",\n    \"httpMethod\": \"POST\",\n    \"contentType\": \"application/json\",\n    \"authentication\": {\n      \"type\": \"API_KEY\",\n      \"username\": \"alert-user\",\n      \"password\": \"******\"\n    },\n    \"requestHeaders\": {\n      \"source\": \"iklim.co\",\n      \"custom-header\": \"value\"\n    },\n    \"deliveryPolicy\": {\n      \"timeout\": 60,\n      \"maxRetries\": 3,\n      \"retryDelay\": 10\n    }\n  },\n  \"filter\": {\n    \"lightning\": {\n      \"type\": \"FLASH_CLOUD_TO_GROUND\",\n      \"peakCurrent\": -12.5,\n      \"inCloudHeight\": 4500\n    },\n    \"thunderstorm\": {\n      \"intersectsAffectedPolygon\": true,\n      \"intersectsCellPolygon\": false,\n      \"severityThreshold\": \"MEDIUM\",\n      \"speedThreshold\": 20\n    },\n    \"precipitation\": {\n      \"intensities\": [\n        \"LIGHT\",\n        \"MODERATE\"\n      ]\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.iklim.co/v1/alarms/points/register")
  .header("Content-Type", "application/json")
  .body("{\n  \"registrationId\": \"f7587d9e-2481-4b4c-818d-c8d1946851b7\",\n  \"recipientId\": \"Recipient1\",\n  \"boundary\": {\n    \"point\": {\n      \"lat\": 39.9208,\n      \"lng\": 32.8541\n    },\n    \"radius\": 10000\n  },\n  \"webhook\": {\n    \"accountId\": \"2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1\",\n    \"url\": \"https://api.customer.com/alerts/callback\",\n    \"httpMethod\": \"POST\",\n    \"contentType\": \"application/json\",\n    \"authentication\": {\n      \"type\": \"API_KEY\",\n      \"username\": \"alert-user\",\n      \"password\": \"******\"\n    },\n    \"requestHeaders\": {\n      \"source\": \"iklim.co\",\n      \"custom-header\": \"value\"\n    },\n    \"deliveryPolicy\": {\n      \"timeout\": 60,\n      \"maxRetries\": 3,\n      \"retryDelay\": 10\n    }\n  },\n  \"filter\": {\n    \"lightning\": {\n      \"type\": \"FLASH_CLOUD_TO_GROUND\",\n      \"peakCurrent\": -12.5,\n      \"inCloudHeight\": 4500\n    },\n    \"thunderstorm\": {\n      \"intersectsAffectedPolygon\": true,\n      \"intersectsCellPolygon\": false,\n      \"severityThreshold\": \"MEDIUM\",\n      \"speedThreshold\": 20\n    },\n    \"precipitation\": {\n      \"intensities\": [\n        \"LIGHT\",\n        \"MODERATE\"\n      ]\n    }\n  }\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.iklim.co/v1/alarms/points/register")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"registrationId\": \"f7587d9e-2481-4b4c-818d-c8d1946851b7\",\n  \"recipientId\": \"Recipient1\",\n  \"boundary\": {\n    \"point\": {\n      \"lat\": 39.9208,\n      \"lng\": 32.8541\n    },\n    \"radius\": 10000\n  },\n  \"webhook\": {\n    \"accountId\": \"2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1\",\n    \"url\": \"https://api.customer.com/alerts/callback\",\n    \"httpMethod\": \"POST\",\n    \"contentType\": \"application/json\",\n    \"authentication\": {\n      \"type\": \"API_KEY\",\n      \"username\": \"alert-user\",\n      \"password\": \"******\"\n    },\n    \"requestHeaders\": {\n      \"source\": \"iklim.co\",\n      \"custom-header\": \"value\"\n    },\n    \"deliveryPolicy\": {\n      \"timeout\": 60,\n      \"maxRetries\": 3,\n      \"retryDelay\": 10\n    }\n  },\n  \"filter\": {\n    \"lightning\": {\n      \"type\": \"FLASH_CLOUD_TO_GROUND\",\n      \"peakCurrent\": -12.5,\n      \"inCloudHeight\": 4500\n    },\n    \"thunderstorm\": {\n      \"intersectsAffectedPolygon\": true,\n      \"intersectsCellPolygon\": false,\n      \"severityThreshold\": \"MEDIUM\",\n      \"speedThreshold\": 20\n    },\n    \"precipitation\": {\n      \"intensities\": [\n        \"LIGHT\",\n        \"MODERATE\"\n      ]\n    }\n  }\n}"

response = http.request(request)
puts response.read_body
{
  "registrationId": "f7587d9e-2481-4b4c-818d-c8d1946851b7",
  "recipientId": "Recipient1",
  "boundary": {
    "point": {
      "lat": 39.9208,
      "lng": 32.8541
    },
    "radius": 10000
  },
  "webhook": {
    "accountId": "2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1",
    "url": "https://api.customer.com/alerts/callback",
    "httpMethod": "POST",
    "contentType": "application/json",
    "authentication": {
      "username": "alert-user",
      "password": "******"
    },
    "requestHeaders": {
      "source": "iklim.co",
      "custom-header": "value"
    },
    "deliveryPolicy": {
      "timeout": 60,
      "maxRetries": 3,
      "retryDelay": 10
    }
  },
  "filter": {
    "lightning": {
      "type": "FLASH_CLOUD_TO_GROUND",
      "peakCurrent": -12.5,
      "inCloudHeight": 4500
    },
    "thunderstorm": {
      "intersectsAffectedPolygon": true,
      "intersectsCellPolygon": false,
      "severityThreshold": "MEDIUM",
      "speedThreshold": 20
    },
    "precipitation": {
      "intensities": [
        "LIGHT",
        "MODERATE"
      ]
    }
  },
  "createdAt": "2025-06-25T11:15:41Z",
  "updatedAt": "2025-06-30T10:05:12Z"
}
{
  "timestamp": "YYYY-mm-DDTHH:MM:SS.nnnnnnnnn",
  "status": "XXX",
  "error": "Error Name",
  "message": "Error Message",
  "path": "/endpoint/uri/here",
  "messages": [
    "<string>"
  ]
}
{
  "timestamp": "YYYY-mm-DDTHH:MM:SS.nnnnnnnnn",
  "status": "XXX",
  "error": "Error Name",
  "message": "Error Message",
  "path": "/endpoint/uri/here",
  "messages": [
    "<string>"
  ]
}
{
  "timestamp": "YYYY-mm-DDTHH:MM:SS.nnnnnnnnn",
  "status": "XXX",
  "error": "Error Name",
  "message": "Error Message",
  "path": "/endpoint/uri/here",
  "messages": [
    "<string>"
  ]
}
{
  "timestamp": "YYYY-mm-DDTHH:MM:SS.nnnnnnnnn",
  "status": "XXX",
  "error": "Error Name",
  "message": "Error Message",
  "path": "/endpoint/uri/here",
  "messages": [
    "<string>"
  ]
}
{
  "timestamp": "YYYY-mm-DDTHH:MM:SS.nnnnnnnnn",
  "status": "XXX",
  "error": "Error Name",
  "message": "Error Message",
  "path": "/endpoint/uri/here",
  "messages": [
    "<string>"
  ]
}
{
  "timestamp": "YYYY-mm-DDTHH:MM:SS.nnnnnnnnn",
  "status": "XXX",
  "error": "Error Name",
  "message": "Error Message",
  "path": "/endpoint/uri/here",
  "messages": [
    "<string>"
  ]
}

Gövde

application/json
​
registrationId
string<uuid>

Mevcut kayıt UUID. Oluşturmada boş bırakın; güncellemede zorunlu.

Örnek:

"f7587d9e-2481-4b4c-818d-c8d1946851b7"

​
recipientId
string

Alıcı kimliği

Örnek:

"Recipient1"

​
boundary
object

Alarmın mekansal sınırı (nokta+yayçap)

​
webhook
object

Alarm geri çağrıları için webhook yapılandırması

​
filter
object

Uygulanacak olay filtreleri (yıldırım, fırtına, yağış)

Yanıt

Kayıt başarıyla oluşturuldu

​
registrationId
string<uuid>

Mevcut kayıt UUID. Oluşturmada boş bırakın; güncellemede zorunlu.

Örnek:

"f7587d9e-2481-4b4c-818d-c8d1946851b7"

​
recipientId
string

Alıcı kimliği

Örnek:

"Recipient1"

​
boundary
object

Alarmın mekansal sınırı (nokta+yayçap)

​
webhook
object

Alarm geri çağrıları için webhook yapılandırması

​
filter
object

Uygulanacak olay filtreleri (yıldırım, fırtına, yağış)

​
createdAt
string<date-time>

Oluşturulma zaman damgası (UTC)

Örnek:

"2025-06-25T11:15:41Z"

​
updatedAt
string<date-time>

Son güncelleme zaman damgası (UTC)

Örnek:

"2025-06-30T10:05:12Z"