i18n - docs translations (#18534)
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com> Co-authored-by: Charles Bochet <charles@twenty.com>
This commit is contained in:
github-actions[bot]
committed by
GitHub
GitHub
parent
d1c95e380e
commit
982f0c4a4d
@@ -0,0 +1,147 @@
|
||||
---
|
||||
title: API'ler
|
||||
description: CRM verilerinizi REST veya GraphQL kullanarak programatik olarak sorgulayın ve değiştirin.
|
||||
---
|
||||
|
||||
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
||||
|
||||
Twenty, geliştirici dostu olacak şekilde tasarlanmıştır ve özel veri modelinize uyum sağlayan güçlü API'ler sunar. Farklı entegrasyon ihtiyaçlarını karşılamak üzere dört farklı API türü sunuyoruz.
|
||||
|
||||
## Geliştirici Öncelikli Yaklaşım
|
||||
|
||||
Twenty, veri modeliniz için özel olarak API'ler oluşturur:
|
||||
|
||||
* **Uzun kimlik numaralarına gerek yok**: Uç noktalarda nesne ve alan adlarınızı doğrudan kullanın
|
||||
* **Standart ve özel nesneler eşit şekilde ele alınır**: Özel nesneleriniz yerleşik olanlarla aynı API muamelesini görür.
|
||||
* **Özel uç noktalar**: Her nesne ve alan kendi API uç noktasına sahiptir
|
||||
* **Özel dokümantasyon**: Çalışma alanınızın veri modeli için özel olarak üretilmiştir.
|
||||
|
||||
<Note>
|
||||
Bir API anahtarı oluşturduktan sonra kişiselleştirilmiş API dokümantasyonunuz **Ayarlar → API ve Webhook'lar** altında mevcuttur. Twenty, özel veri modelinize uyan API'ler oluşturduğundan, dokümantasyon çalışma alanınıza özeldir.
|
||||
</Note>
|
||||
|
||||
## İki API Türü
|
||||
|
||||
### Temel API
|
||||
|
||||
`/rest/` veya `/graphql/` üzerinden erişilebilir.
|
||||
|
||||
Gerçek **kayıtlarınızla** (verilerin kendisiyle) çalışın:
|
||||
|
||||
* People, Companies, Opportunities vb. oluşturun, okuyun, güncelleyin, silin.
|
||||
* Verileri sorgulayın ve filtreleyin
|
||||
* Kayıt ilişkilerini yönetin
|
||||
|
||||
### Meta Veri API
|
||||
|
||||
`/rest/metadata/` veya `/metadata/` üzerinden erişilebilir.
|
||||
|
||||
**Çalışma alanınızı ve veri modelinizi** yönetin:
|
||||
|
||||
* Nesne ve alanlar oluşturun, değiştirin veya silin
|
||||
* Çalışma alanı ayarlarını yapılandırın
|
||||
* Nesneler arasındaki ilişkileri tanımlayın
|
||||
|
||||
## REST ve GraphQL
|
||||
|
||||
Hem Temel hem de Meta Veri API'leri, REST ve GraphQL formatlarında mevcuttur:
|
||||
|
||||
| Biçim | Kullanılabilir İşlemler |
|
||||
| ----------- | -------------------------------------------------------------------------------- |
|
||||
| **REST** | CRUD, toplu işlemler, ekleme-güncelleme işlemleri |
|
||||
| **GraphQL** | Aynısı + **toplu ekleme-güncelleme işlemleri**, tek bir çağrıda ilişki sorguları |
|
||||
|
||||
İhtiyaçlarınıza göre seçin — her iki format da aynı verilere erişir.
|
||||
|
||||
## API Uç Noktaları
|
||||
|
||||
| Ortam | Temel URL |
|
||||
| ---------------------------- | ------------------------- |
|
||||
| **Bulut** | `https://api.twenty.com/` |
|
||||
| **Kendi Kendine Barındırma** | `https://{your-domain}/` |
|
||||
|
||||
## Kimlik Doğrulama
|
||||
|
||||
Her API isteği, başlıkta bir API anahtarı gerektirir:
|
||||
|
||||
```
|
||||
Authorization: Bearer YOUR_API_KEY
|
||||
```
|
||||
|
||||
### Bir API Anahtarı Oluştur
|
||||
|
||||
1. **Ayarlar → API ve Webhook'lar**'a gidin
|
||||
2. **+ Anahtar oluştur**'a tıklayın
|
||||
3. Yapılandırın:
|
||||
* **Ad**: Anahtar için açıklayıcı bir ad
|
||||
* **Son Kullanma Tarihi**: Anahtarın ne zaman sona ereceği
|
||||
4. **Kaydet**'e tıklayın
|
||||
5. **Hemen kopyalayın** — anahtar yalnızca bir kez gösterilir
|
||||
|
||||
<VimeoEmbed videoId="928786722" title="API anahtarı oluşturma" />
|
||||
|
||||
<Warning>
|
||||
API anahtarınız hassas verilere erişim sağlar. Güvenilmeyen hizmetlerle paylaşmayın. Tehlikeye girerse, onu hemen devre dışı bırakın ve yenisini oluşturun.
|
||||
</Warning>
|
||||
|
||||
### Bir API Anahtarına Rol Atama
|
||||
|
||||
Daha iyi güvenlik için, erişimi sınırlamak amacıyla belirli bir rol atayın:
|
||||
|
||||
1. **Ayarlar → Roller** bölümüne gidin
|
||||
2. Atamak istediğiniz role tıklayın
|
||||
3. **Atama** sekmesini açın
|
||||
4. **API Anahtarları** altında, **+ API anahtarına ata**'ya tıklayın
|
||||
5. API anahtarını seçin
|
||||
|
||||
Anahtar, o rolün izinlerini devralacaktır. Ayrıntılar için [İzinler](/l/tr/user-guide/permissions-access/capabilities/permissions) bölümüne bakın.
|
||||
|
||||
### API Anahtarlarını Yönet
|
||||
|
||||
**Yeniden Oluştur**: Ayarlar → API ve Webhook'lar → Anahtara tıklayın → **Yeniden Oluştur**
|
||||
|
||||
**Sil**: Ayarlar → API ve Webhook'lar → Anahtara tıklayın → **Sil**
|
||||
|
||||
## API Oyun Alanı
|
||||
|
||||
Yerleşik oyun alanımız ile API'lerinizi doğrudan tarayıcıda test edin — hem **REST** hem de **GraphQL** için kullanılabilir.
|
||||
|
||||
### Oyun Alanına Erişin
|
||||
|
||||
1. **Ayarlar → API ve Webhook'lar**'a gidin
|
||||
2. Bir API anahtarı oluşturun (gerekli)
|
||||
3. Oyun alanını açmak için **REST API** veya **GraphQL API**'ye tıklayın
|
||||
|
||||
### Elde Edecekleriniz
|
||||
|
||||
* **Etkileşimli dokümantasyon**: Belirli veri modeliniz için oluşturulur
|
||||
* **Canlı test**: Çalışma alanınıza karşı gerçek API çağrılarını gerçekleştirin
|
||||
* **Şema gezgini**: Kullanılabilir nesnelere, alanlara ve ilişkilere göz atın
|
||||
* **İstek oluşturucu**: Otomatik tamamlama ile sorgular oluşturun
|
||||
|
||||
Oyun alanı, özel nesnelerinizi ve alanlarınızı yansıtır, bu nedenle dokümantasyon çalışma alanınız için her zaman doğrudur.
|
||||
|
||||
## Toplu İşlemler
|
||||
|
||||
Hem REST hem de GraphQL, toplu işlemleri destekler:
|
||||
|
||||
* **Toplu boyut**: İstek başına 60 kayıt kadar
|
||||
* **İşlemler**: Birden çok kaydı oluşturma, güncelleme, silme
|
||||
|
||||
**Yalnızca GraphQL Özellikleri:**
|
||||
|
||||
* **Toplu Ekleme-Güncelleme**: Tek bir çağrıda oluşturun veya güncelleyin
|
||||
* Çoğul nesne adlarını kullanın (ör. `CreateCompany` yerine `CreateCompanies`)
|
||||
|
||||
## Hız Sınırları
|
||||
|
||||
Platform kararlılığını sağlamak için API istekleri kısıtlanır:
|
||||
|
||||
| Sınır | Değer |
|
||||
| ---------------- | --------------------- |
|
||||
| **İstekler** | Dakikada 100 çağrı |
|
||||
| **Toplu boyutu** | Çağrı başına 60 kayıt |
|
||||
|
||||
<Tip>
|
||||
Verimi en üst düzeye çıkarmak için toplu işlemleri kullanın — tekil istekler yapmak yerine tek bir API çağrısında 60 kayda kadar işleyin.
|
||||
</Tip>
|
||||
Reference in New Issue
Block a user