> ## Documentation Index
> Fetch the complete documentation index at: https://docs.azalt.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Hızlı Başlangıç

> 10 dakikada ilk sürdürülebilirlik veri toplama sisteminizi oluşturun

export const baseUrl = "https://azalt.co";

Bu hızlı başlangıç rehberi, organizasyonel yapınızı oluşturmaktan enerji verisi toplamaya ve KPI üretmeye kadar kapsamlı bir sürdürülebilirlik veri toplama sistemi kurmanıza yardımcı olur.

## 1. Kimlik Doğrulama Kurulumu

API anahtarınızı <a href={`${baseUrl}/settings/api-keys`} target="_blank">{baseUrl}/settings/api-keys</a> adresinde oluşturun.

<img src="https://mintcdn.com/erguvan/dG3QWQrGg3YhhuHF/images/apikey.png?fit=max&auto=format&n=dG3QWQrGg3YhhuHF&q=85&s=e2e48500c380c13ab816724c0215d25f" style={{ borderRadius: "0.5rem" }} width="2874" height="1334" data-path="images/apikey.png" />

Kimlik doğrulamanızı test edin:

```bash theme={null}
curl --request GET \
  --url https://app.azalt.co/api/v1/users/me \
  --header 'Authorization: Bearer ERG-your-api-key'
```

## 2. Site Yapınızı Oluşturun

Öncelikle verileri toplayacağımız bir üretim tesisini oluşturalım:

```bash theme={null}
curl --request POST \
  --url https://app.azalt.co/api/v1/site.create \
  --header 'Authorization: Bearer ERG-your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Manufacturing Plant A",
    "country": "United States",
    "city": "Detroit",
    "numberOfEmployees": 250,
    "floorAreaInM2": 15000
  }'
```

## 3. Enerji Takip Formu Oluşturun

Şimdi aylık enerji tüketim verilerini toplamak için bir form oluşturalım:

```bash theme={null}
curl --request POST \
  --url https://app.azalt.co/api/v1/form.create \
  --header 'Authorization: Bearer ERG-your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Monthly Energy Tracking",
    "description": "Track electricity and natural gas consumption",
    "elements": [
      {
        "key": "electricity_consumption",
        "label": "Electricity Consumption",
        "type": "NUMBER",
        "required": true,
        "unit": "kWh",
        "period": "MONTHLY"
      },
      {
        "key": "natural_gas_consumption",
        "label": "Natural Gas Consumption",
        "type": "NUMBER",
        "required": true,
        "unit": "m³",
        "period": "MONTHLY"
      }
    ],
    "siteIds": ["your-site-id"],
    "years": [2024]
  }'
```

## 4. Enerji Verilerini Gönderin

Ocak 2024'e ait gerçek tüketim verilerini gönderin:

```bash theme={null}
curl --request POST \
  --url https://app.azalt.co/api/v1/measurement.collect \
  --header 'Authorization: Bearer ERG-your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "formId": "your-form-id",
    "siteId": "your-site-id",
    "year": 2024,
    "values": [
      {
        "elementId": "electricity-element-id",
        "value": 125000,
        "periodUnit": 1
      },
      {
        "elementId": "gas-element-id",
        "value": 8500,
        "periodUnit": 1
      }
    ]
  }'
```

## 5. Enerji Yoğunluğu KPI'ı Oluşturun

Enerji verimliliğini (kWh/çalışan) takip etmek için bir KPI oluşturun:

```bash theme={null}
curl --request POST \
  --url https://app.azalt.co/api/v1/indicator.create \
  --header 'Authorization: Bearer ERG-your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Energy Intensity per Employee",
    "description": "Monthly electricity consumption per employee",
    "unit": "kWh/employee",
    "expression": [
      {
        "type": "form_element",
        "formElementId": "electricity-element-id"
      },
      {
        "type": "operator",
        "operator": "/"
      },
      {
        "type": "number",
        "value": 250
      }
    ]
  }'
```

## 6. Sonuçları Görüntüleyin

Hesaplanan KPI değerini alın:

```bash theme={null}
curl --request GET \
  --url 'https://app.azalt.co/api/v1/indicator.calculate?indicatorId=your-indicator-id&siteId=your-site-id&year=2024&periodUnit=1' \
  --header 'Authorization: Bearer ERG-your-api-key'
```

**Yanıt:**

```json theme={null}
{
  "value": 500,
  "unit": "kWh/employee",
  "siteId": "your-site-id",
  "year": 2024,
  "periodUnit": 1
}
```

## 🎉 Tebrikler!

Artık tam bir sürdürülebilirlik veri sistemi kurdunuz:

* ✅ **Organizasyon Yapısı**: Operasyonel ayrıntılarıyla bir üretim tesisi oluşturdunuz
* ✅ **Veri Toplama**: Zaman periyodlu veri toplama özelliklerine sahip bir form oluşturdunuz
* ✅ **Veri Gönderimi**: Gerçek enerji tüketim verilerini gönderdiniz
* ✅ **KPI Oluşturma**: Otomatik hesaplamalarla bir verimlilik göstergesi oluşturdunuz
* ✅ **Analitik**: Hesaplanan sürdürülebilirlik metriklerini çektiniz

## Sonraki Adımlar

* **Gelişmiş Özellikleri Keşfedin**: Formlarınıza [koşullu mantık](/concepts/overview#conditional-logic) ekleyin
* **Harici Veri Toplama**: Tedarikçi verileri için [genel formlar](/concepts/overview#external-forms) oluşturun
* **Karmaşık Hesaplamalar**: Özel JavaScript ile [aktivite tanımları](/concepts/overview#activity--activitydefinition) oluşturun
* **Panolar**: Verilerinize ait [etkileşimli görselleştirmeler](/concepts/overview#dashboard--widget) hazırlayın
* **API Referansı**: Tüm [API dokümantasyonunu](/api-reference) inceleyin

Detaylı kavramlar ve mimariye ilişkin bilgiler için [Platform Genel Bakışı](/concepts) sayfasına göz atın.