# Hızlı başlangıç

> API anahtarı açın, kimliğinizi doğrulayın, ilk görevinizi oluşturun ve bir olaya abone olun.

Bu kılavuz sonunda bir API anahtarınız olacak, CRM'den veri okumuş, bir görev açmış ve fırsat kazanıldığında haber alacak bir web kancası kurmuş olacaksınız.

:::steps
### API anahtarı açın

CRM'e **yönetici** hesabıyla girin ve **Ayarlar → Geliştiriciler** sayfasını açın (`https://ornek.solk.app/settings/developers`). Anahtara tanınır bir ad verin (ör. "Muhasebe eşitleme") ve **Anahtar oluştur**'a basın.

Anahtar `sk_` ile başlar ve **yalnız bir kez** gösterilir; hemen bir parola kasasına kaydedin. Anahtar, onu açan yöneticinin yetkileriyle çalışır ve iptal edilene kadar geçerlidir.

:::warning
API anahtarı tam yetkili bir parola gibidir. Tarayıcıda çalışan koda, mobil uygulamaya ya da herkese açık bir depoya koymayın. Kullanıcı adına çalışan uygulamalar için [OAuth](/rest-api/oauth) kullanın.
:::

### Kimliğinizi doğrulayın

Her isteğe `Authorization: Bearer <anahtar>` başlığını ekleyin. İlk çağrı [`GET /api/v1/me`](/rest-api/auth/me) olsun: anahtarın kime ait olduğunu, açık modülleri ve kurulumun aşama anahtarlarını döndürür.

:::code
```bash cURL
curl https://ornek.solk.app/api/v1/me \
  -H "Authorization: Bearer $SOLK_API_KEY"
```
```javascript JavaScript
const res = await fetch("https://ornek.solk.app/api/v1/me", {
  headers: { Authorization: `Bearer ${process.env.SOLK_API_KEY}` },
});
const me = await res.json();
console.log(me.user.full_name, me.constants.stages);
```
```python Python
import os, requests

r = requests.get("https://ornek.solk.app/api/v1/me",
                 headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"})
me = r.json()
print(me["user"]["full_name"], me["constants"]["stages"])
```
:::

Yanıttaki `ok: true` isteğin başarılı olduğunu gösterir. Başarısız isteklerde `ok: false`, makinece okunur bir `error` kodu ve kullanıcıya gösterilebilecek bir `message` gelir — ayrıntı [Hatalar](/rest-api/errors) sayfasında.

### Kayıtları okuyun

Açık fırsatları değerine göre sıralı alın:

```bash
curl "https://ornek.solk.app/api/v1/opportunities?scope=all&sort=value&per=10" \
  -H "Authorization: Bearer $SOLK_API_KEY"
```

Liste uçları `rows`, `total`, `page` ve `pages` döndürür. Tek bir kaydın tamamı için kimliğiyle isteyin: [`GET /api/v1/opportunities/{id}`](/rest-api/deals/get).

### Görev oluşturun

```bash
curl https://ornek.solk.app/api/v1/tasks \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Fiyat listesini gönder",
    "customer": "Kuzey Plastik Sanayi",
    "due_date": "2026-10-05",
    "due_time": "10:30",
    "priority": "Yüksek"
  }'
```

Görev, anahtarın sahibine atanır (başka birine atamak için `assigned_to`). Firma adla bulunur; kendiliğinden proje açılmaz. Görev hemen CRM'de **Aksiyonlar** listesinde ve sorumlusunun telefon takviminde görünür.

### Olaylara abone olun

**Ayarlar → Uygulamalar → Web kancası**'nı açın, alıcı adresinizi girin ve **Fırsat kazanıldı** olayını seçin. CRM, olay olduğunda adresinize imzalı bir JSON gönderir:

```json
{
  "event": "opp_won",
  "title": "Fırsat kazanıldı",
  "text": "Kuzey Plastik Sanayi · Streç film tedariki · 338.400 € · Sorumlu: Deniz Aksoy",
  "url": "https://ornek.solk.app/opportunities/53",
  "data": { "id": 53, "rid": "006Xq3…", "name": "Streç film tedariki", "customer": "Kuzey Plastik Sanayi",
            "customer_id": 31, "stage": "Win", "stage_label": "Win", "value": 338400.0, "currency": "EUR", "owner": "Deniz Aksoy" },
  "workspace": "Örnek Kimya",
  "app": "Solk CRM",
  "sent_at": "2026-10-02T14:05:11"
}
```

İmzanın nasıl doğrulanacağı [Web kancaları](/guides/webhooks) sayfasında.
:::

## Sonraki adımlar

:::cards
- [Kimlik doğrulama](/rest-api/authentication) key | Anahtar türleri, yetki ve iptal.
- [Fırsatlar](/rest-api/deals/list) target | Aşama değiştirme, BANT, adımlar.
- [Görüşme kaydet](/rest-api/activities/log) phone | Telefon ve ziyaret kaydını tek istekte açın.
- [MCP](/mcp/overview) spark | Aynı işleri Claude'dan doğal dille yapın.
:::