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.

1. 1

   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.

   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 kullanın.

2. 2

   Kimliğinizi doğrulayın

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

   cURLJavaScriptPython

   curl https://ornek.solk.app/api/v1/me \
     -H "Authorization: Bearer $SOLK_API_KEY"

   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 sayfasında.

3. 3

   Kayıtları okuyun

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

   cURL

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

4. 4

   Görev oluşturun

   cURL

   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.

5. 5

   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ı sayfasında.

Sonraki adımlar