# info.description
Frigolive Public API, müşterilerin soğuk zincir telemetrisini ve cihaz verilerini
kendi ürünlerine entegre etmesi için sunulan kararlı, sürümlenmiş sözleşmedir.

- Kimlik doğrulama: OAuth 2.0 client credentials (`POST /api/public/v1/oauth/token/`).
  Erişim jetonu yaklaşık 1 saat geçerlidir ve yenileme jetonu yoktur.
- Yetkilendirme: her istek scope, hesap izin listesi ve tenant sahipliği ile ayrı ayrı doğrulanır.
- Çoklu hesap: credential birden fazla şirkete açıksa `X-Frigolive-Account-ID` başlığı zorunludur.
- Idempotency: kayıt oluşturan `POST` işlemleri 8-128 karakterlik `Idempotency-Key` başlığı bekler.
- Hız sınırı: her yanıt `X-RateLimit-Limit`, `X-RateLimit-Remaining` ve `X-RateLimit-Reset` döner.

Rehberler ve canlı deneme: https://developer.frigolive.com

# paths./api/public/v1/accounts/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/accounts/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/accounts/{account_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/accounts/{account_id}/.patch.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/alarms/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/alarms/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/alarms/{alarm_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/alarms/{alarm_id}/.patch.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/alert-presets/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/alert-presets/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/alert-presets/.post.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/alert-presets/{preset_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/alert-presets/{preset_id}/.put.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/alert-presets/{preset_id}/.patch.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/alert-presets/{preset_id}/.delete.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/carriers/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/carriers/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/carriers/.post.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/carriers/{carrier_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/carriers/{carrier_id}/.put.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/carriers/{carrier_id}/.patch.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/carriers/{carrier_id}/.delete.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/devices/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/devices/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/devices/{device_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/devices/{device_id}/alarms/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/devices/{device_id}/alarms/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/devices/{device_id}/label/.patch.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/devices/{device_id}/maintenance/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/devices/{device_id}/maintenance/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/devices/{device_id}/settings/.patch.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/devices/{device_id}/status/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/devices/{device_id}/telemetry/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/devices/{device_id}/telemetry/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/locations/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/locations/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/locations/.post.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/locations/{location_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/locations/{location_id}/.put.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/locations/{location_id}/.patch.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/locations/{location_id}/.delete.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/receivers/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/receivers/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/receivers/.post.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/receivers/{receiver_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/receivers/{receiver_id}/.put.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/receivers/{receiver_id}/.patch.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/receivers/{receiver_id}/.delete.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/reports/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/reports/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/reports/{report_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/reports/{report_id}/download/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/roles/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipment-templates/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipment-templates/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/shipment-templates/.post.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipment-templates/{template_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipment-templates/{template_id}/.put.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipment-templates/{template_id}/.patch.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipment-templates/{template_id}/.delete.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipments/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipments/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/shipments/{shipment_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipments/{shipment_id}/.put.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipments/{shipment_id}/.delete.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipments/{shipment_id}/complete/.post.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipments/{shipment_id}/share/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipments/{shipment_id}/share/.put.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipments/{shipment_id}/share/.delete.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipments/{shipment_id}/tracking/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/shipments/{shipment_id}/tracking/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/shipments/create/.post.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/user-invitations/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/user-invitations/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/user-invitations/.post.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/user-invitations/{invitation_id}/.delete.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/users/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/users/.get.parameters[].description
A page number within the paginated result set.

# paths./api/public/v1/users/{user_id}/.get.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/users/{user_id}/.patch.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# paths./api/public/v1/users/{user_id}/.delete.description
Stable error contract, rate-limit headers and metadata-only audit logging.

# components.schemas.PatchedPublicAccountUpdate.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PatchedPublicAlarmStatus.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PatchedPublicAlertPreset.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PatchedPublicCarrier.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PatchedPublicCarrier.properties.transport_type.description
* `LAND` - Kara taşıtı
* `SEA` - Deniz taşıtı
* `AIR` - Hava taşıtı
* `RAIL` - Demiryolu

# components.schemas.PatchedPublicDeviceLabel.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PatchedPublicDeviceSettings.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PatchedPublicDeviceSettings.properties.measure_interval.description
Ölçüm aralığı, DAKİKA. Geçerli değerler: 5, 10, 15, 30, 45, 60, 90, 120. Listede olmayan bir değer kaydedilirken en yakınına yuvarlanır.

# components.schemas.PatchedPublicDeviceSettings.properties.transmission_interval.description
Gönderim aralığı, DAKİKA. Ölçüm aralığına eşit veya onun tam katı olmalıdır; küçükse ölçüm aralığına yükseltilir.

# components.schemas.PatchedPublicDeviceSettings.properties.startup_delay.description
Cihazın açılıştan sonra ilk ölçüme kadar beklediği süre, DAKİKA.

# components.schemas.PatchedPublicLocation.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PatchedPublicLocation.properties.shape.description
* `CIRCLE` - Circle
* `POLYGON` - Polygon

# components.schemas.PatchedPublicLocation.properties.radius_m.description
Daire yarıçapı, metre. En az 100, en fazla 200000.

# components.schemas.PatchedPublicLocation.properties.polygon.description
Çokgen köşeleri: [[enlem, boylam], ...] — en az 3 nokta. Sıra [lat, lng]'dir, GeoJSON'un [lng, lat] sırası DEĞİLDİR. Enlem -90..90, boylam -180..180 dışındaysa 400 döner.

# components.schemas.PatchedPublicLocation.properties.inside_measure_interval.description
Bölge içindeyken ölçüm aralığı, DAKİKA. Geçerli değerler: 5, 10, 15, 30, 45, 60, 90, 120.

# components.schemas.PatchedPublicLocation.properties.inside_transmission_interval.description
Bölge içindeyken gönderim aralığı, DAKİKA. Ölçüm aralığının tam katı olmalı ve 1440'ı (24 saat) aşmamalıdır.

# components.schemas.PatchedPublicReceiver.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PatchedPublicShipmentTemplate.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PatchedPublicShipmentTemplate.properties.transport_type.description
* `LAND` - Kara
* `AIR` - Hava
* `SEA` - Deniz
* `RAIL` - Raylı

# components.schemas.PatchedPublicUserUpdate.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PatchedPublicUserUpdate.properties.role.description
* `MANAGER` - MANAGER
* `VIEWER` - VIEWER
* `OPERATOR` - OPERATOR

# components.schemas.PublicAlarm.properties.severity.description
* `CRITICAL` - Critical
* `WARNING` - Warning
* `INFO` - Info

# components.schemas.PublicAlarm.properties.source.description
* `THRESHOLD` - User Threshold
* `ANOMALY` - Sensor Anomaly

# components.schemas.PublicAlertPreset.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicCarrier.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicCarrier.properties.transport_type.description
* `LAND` - Kara taşıtı
* `SEA` - Deniz taşıtı
* `AIR` - Hava taşıtı
* `RAIL` - Demiryolu

# components.schemas.PublicDevice.properties.device_status.description
* `ACTIVE` - Active
* `PASSIVE` - Passive
* `MAINTENANCE` - Maintenance
* `FAULTY` - Faulty
* `GSM_EXPIRED` - GSM Expired
* `SIM_SWAPPED` - SIM Swapped

# components.schemas.PublicDevice.properties.lifecycle_status.description
* `IN_SERVICE` - In service
* `EXPIRED` - Expired
* `COLLECTED` - Collected
* `REFURBISHING` - Refurbishing

# components.schemas.PublicDevice.properties.measure_interval.description
Ölçüm aralığı, DAKİKA. Geçerli değerler: 5, 10, 15, 30, 45, 60, 90, 120. Listede olmayan bir değer kaydedilirken en yakınına yuvarlanır.

# components.schemas.PublicDevice.properties.transmission_interval.description
Gönderim aralığı, DAKİKA. Ölçüm aralığına eşit veya onun tam katı olmalıdır; küçükse ölçüm aralığına yükseltilir.

# components.schemas.PublicDevice.properties.startup_delay.description
Cihazın açılıştan sonra ilk ölçüme kadar beklediği süre, DAKİKA.

# components.schemas.PublicDeviceLabel.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicDeviceSettings.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicDeviceSettings.properties.measure_interval.description
Ölçüm aralığı, DAKİKA. Geçerli değerler: 5, 10, 15, 30, 45, 60, 90, 120. Listede olmayan bir değer kaydedilirken en yakınına yuvarlanır.

# components.schemas.PublicDeviceSettings.properties.transmission_interval.description
Gönderim aralığı, DAKİKA. Ölçüm aralığına eşit veya onun tam katı olmalıdır; küçükse ölçüm aralığına yükseltilir.

# components.schemas.PublicDeviceSettings.properties.startup_delay.description
Cihazın açılıştan sonra ilk ölçüme kadar beklediği süre, DAKİKA.

# components.schemas.PublicDeviceStatus.properties.device_status.description
* `ACTIVE` - Active
* `PASSIVE` - Passive
* `MAINTENANCE` - Maintenance
* `FAULTY` - Faulty
* `GSM_EXPIRED` - GSM Expired
* `SIM_SWAPPED` - SIM Swapped

# components.schemas.PublicDeviceStatus.properties.lifecycle_status.description
* `IN_SERVICE` - In service
* `EXPIRED` - Expired
* `COLLECTED` - Collected
* `REFURBISHING` - Refurbishing

# components.schemas.PublicInvitation.properties.status.description
* `PENDING` - PENDING
* `ACCEPTED` - ACCEPTED
* `EXPIRED` - EXPIRED

# components.schemas.PublicInvitationCreate.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicInvitationCreate.properties.role.description
* `MANAGER` - MANAGER
* `VIEWER` - VIEWER
* `OPERATOR` - OPERATOR

# components.schemas.PublicLocation.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicLocation.properties.shape.description
* `CIRCLE` - Circle
* `POLYGON` - Polygon

# components.schemas.PublicLocation.properties.radius_m.description
Daire yarıçapı, metre. En az 100, en fazla 200000.

# components.schemas.PublicLocation.properties.polygon.description
Çokgen köşeleri: [[enlem, boylam], ...] — en az 3 nokta. Sıra [lat, lng]'dir, GeoJSON'un [lng, lat] sırası DEĞİLDİR. Enlem -90..90, boylam -180..180 dışındaysa 400 döner.

# components.schemas.PublicLocation.properties.inside_measure_interval.description
Bölge içindeyken ölçüm aralığı, DAKİKA. Geçerli değerler: 5, 10, 15, 30, 45, 60, 90, 120.

# components.schemas.PublicLocation.properties.inside_transmission_interval.description
Bölge içindeyken gönderim aralığı, DAKİKA. Ölçüm aralığının tam katı olmalı ve 1440'ı (24 saat) aşmamalıdır.

# components.schemas.PublicMaintenance.properties.type.description
* `MAINTENANCE` - Maintenance
* `FAULTY` - Faulty
* `REPAIR` - Repair
* `CALIBRATION` - Calibration

# components.schemas.PublicReceiver.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicReport.properties.report_type.description
* `DEVICE` - Cihaz
* `SHIPMENT` - Sevkiyat

# components.schemas.PublicShipment.properties.status.description
* `ACTIVE` - ACTIVE
* `COMPLETED` - COMPLETED

# components.schemas.PublicShipment.properties.transport_type.description
* `LAND` - Kara
* `AIR` - Hava
* `SEA` - Deniz
* `RAIL` - Raylı

# components.schemas.PublicShipmentComplete.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicShipmentCreate.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicShipmentCreate.properties.transport_type.description
* `LAND` - Kara
* `AIR` - Hava
* `SEA` - Deniz
* `RAIL` - Raylı

# components.schemas.PublicShipmentShare.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicShipmentTemplate.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicShipmentTemplate.properties.transport_type.description
* `LAND` - Kara
* `AIR` - Hava
* `SEA` - Deniz
* `RAIL` - Raylı

# components.schemas.PublicShipmentUpdate.description
Safe customer-managed subset for an active shipment.

Every field is optional so callers can update one logical part without
resending the complete route. Unknown/internal fields are still rejected.

# components.schemas.PublicShipmentUpdate.properties.transport_type.description
* `LAND` - Kara
* `AIR` - Hava
* `SEA` - Deniz
* `RAIL` - Raylı

# components.schemas.PublicTokenRequest.description
Public contracts reject typos instead of silently ignoring them.

# components.schemas.PublicUser.properties.username.description
Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.

# components.schemas.PublicUser.properties.role.description
* `COMPANY_ADMIN` - Company Admin
* `MANAGER` - Manager
* `VIEWER` - Viewer
* `OPERATOR` - Operator

# components.schemas.PublicUser.properties.is_active.description
Designates whether this user should be treated as active. Unselect this instead of deleting accounts.

# components.securitySchemes.PublicApiBearer.description
Short-lived access token obtained from POST /api/public/v1/oauth/token/.

# tags[].description
Cihaz görünümü, durum ve müşteri ayarları.