> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/tr/tools/api-integration.md).

# Özel API Entegrasyonu

API Cagrisi araci, Crew'u REST API'si olan herhangi bir dis hizmete baglamaniza olanak tanir. Bu, Crew'un en esnek aracidir — bir hizmetin API'si varsa baglayabilirsiniz.

## Nasil Calisir?

1. API kimlik bilgilerinizi Ayarlar'da **saklayin**
2. Crew'dan dogal dille API'yi cagirmasini **isteyin**
3. Crew API istegini olusturur ve sonuclari dondurur

## Kimlik Bilgisi Ayarlama

Harici bir API kullanmadan once API anahtarinizi saklayin:

1. **Ayarlar**'a gidin
2. **API Kimlik Bilgileri**'ne ilerleyin (veya API anahtari gerektiren bir Pazar Yeri becerisi yuklerken yapilandirin)
3. Kimlik bilginizi ekleyin:
   * **Anahtar adi**: `BENIM_SERVIS_API_ANAHTARIM` gibi bir etiket
   * **Deger**: Gercek API anahtariniz

Kimlik bilgileri sifrelenmis ve guvenli sekilde saklanir. Crew API cagrisi yaptiginda, kimlik bilgisini `{{ANAHTAR_ADI}}` yer tutucusu kullanarak enjekte eder — gercek anahtar konusmada asla gosterilmez.

## API Cagrisi Yapma

### Basit GET Istegi

> "JSONPlaceholder API'sini cagir ve ilk 5 gonderiyi al: GET <https://jsonplaceholder.typicode.com/posts?\\_limit=5>"

### Kimlik Dogrulamali Istek

> "API anahtarimla Airtable veritabanimi kontrol et: GET <https://api.airtable.com/v0/appXXXXX/Table1> Authorization: Bearer {{AIRTABLE\_API\_KEY}}"

### POST Istegi

> "Proje yonetim aracimda yeni bir gorev olustur: POST <https://api.ornek.com/gorevler> body { "baslik": "Teklifi incele", "oncelik": "yuksek" }"

## Desteklenen HTTP Metodlari

* **GET** — Veri alma
* **POST** — Yeni kaynak olusturma
* **PUT** — Mevcut kaynaklari degistirme
* **PATCH** — Kismii guncelleme
* **DELETE** — Kaynak silme

## Yanit Turleri

* **JSON** — Yapilandirilmis veri (varsayilan)
* **Metin** — Duz metin yanitlari
* **Binary** — Dosya indirmeleri

## Zaman Asimi

* Varsayilan: 30 saniye
* Maksimum: 120 saniye

## Pratik Ornekler

### Airtable Entegrasyonu

> "Airtable API anahtarimla 'Projeler' tablosundaki tum kayitlari listele ve her projenin durumunu ozetle."

### Slack Webhook

> "Bu webhook URL'sini kullanarak ekibimizin Slack kanalina mesaj gonder: \[webhook URL]. Mesaj: 'Haftalik rapor hazir.'"

### Ozel CRM

> "CRM API anahtarimla CRM API'mizden son firsatlari kontrol et: GET <https://api.bizimcrm.com/firsatlar?durum=acik>."

### Hava Durumu Servisi

> "OpenWeatherMap API'sini kullanarak Istanbul icin 5 gunluk tahmini al."

### API'leri Birlestirme

> "Finansal API'yi kullanarak THYAO hisse fiyatini kontrol et, sonra sonucu Slack kanalimiza webhook ile gonder."

## Plan Limitleri

| Plan     | Pazar Yeri Araclari (API araclari dahil) |
| -------- | ---------------------------------------- |
| Ucretsiz | 1                                        |
| Basic    | 5                                        |
| Plus     | 15                                       |
| Pro      | Sinirsiz                                 |

## Guvenlik

* Kimlik bilgileri beklemede sifrelidir (AES-256-GCM)
* API anahtarlari konusma yanitlarinda asla gosterilmez
* `{{ANAHTAR_ADI}}` yer tutucu sistemi, anahtarlarin yalnizca calistirma sirasinda enjekte edilmesini saglar
* Saklanan kimlik bilgilerini istediginiz zaman Ayarlar'dan silebilirsiniz

## Ipuclari

* **Basit baslayin**: Karmasik is akislari olusturmadan once basit bir GET istegiyle test edin
* **API dokumanlarini kontrol edin**: Uç nokta formatini ve gerekli baslikclari bildiginizden emin olun
* **Zamanlanmis gorevlerle kullanin**: Otomatik izleme icin API cagrilarni zamanlanmis gorevlerle birlestirin
* **Zincirleme istekler**: Crew'dan sirayla birden fazla API cagrisi yapmasini isteyebilirsiniz — ornegin "A API'sinden veri al, isle, sonra sonucu B API'sine gonder"