mirror of
https://github.com/twentyhq/twenty.git
synced 2026-06-14 10:59:20 -04:00
56 lines
2.7 KiB
Plaintext
56 lines
2.7 KiB
Plaintext
---
|
||
title: API'ler
|
||
icon: plug
|
||
description: Çalışma alanı şemanızdan oluşturulan REST ve GraphQL API'leri.
|
||
---
|
||
|
||
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
||
|
||
## Kiracı başına şema API'leri
|
||
|
||
Twenty için statik bir API referansı yoktur. Her çalışma alanının kendine ait bir şeması vardır — özel bir nesne (ör. `Invoice`) eklediğinizde, `Company` veya `Person` gibi yerleşik nesnelerle aynı olan REST ve GraphQL uç noktalarını anında edinir. API şemadan oluşturulur, bu nedenle uç noktalar nesne ve alan adlarınızı doğrudan kullanır — anlaşılmaz kimlikler yoktur.
|
||
|
||
Bir API anahtarı oluşturduktan sonra çalışma alanınıza özel API dokümantasyonu **Ayarlar → API ve Webhook'lar** altında mevcuttur. Verilerinize karşı gerçek çağrılar çalıştırabileceğiniz etkileşimli bir deneme alanı içerir.
|
||
|
||
## İki API
|
||
|
||
**Çekirdek API** — `/rest/` ve `/graphql/`
|
||
|
||
Kayıtlar üzerinde CRUD: Kişiler, Şirketler, Fırsatlar ve özel nesneleriniz. Sorgulama, filtreleme, ilişkilerde gezinme.
|
||
|
||
**Meta veri API'si** — `/rest/metadata/` ve `/metadata/`
|
||
|
||
Şema yönetimi: nesneleri, alanları ve ilişkileri oluşturma/değiştirme/silme. Programatik olarak veri modelinizi bu şekilde değiştirirsiniz.
|
||
|
||
Her ikisi de REST ve GraphQL olarak mevcuttur. GraphQL, toplu upsert işlemleri ve ilişkilerde tek bir sorguda gezinme olanağı sağlar. Her iki yöntemde de aynı temel veri kullanılır.
|
||
|
||
## Temel URL'ler
|
||
|
||
| Ortam | Temel URL |
|
||
| ------------------ | ------------------------- |
|
||
| Bulut | `https://api.twenty.com/` |
|
||
| Kendi barındırmalı | `https://{your-domain}/` |
|
||
|
||
## Kimlik Doğrulama
|
||
|
||
```
|
||
Authorization: Bearer YOUR_API_KEY
|
||
```
|
||
|
||
**Settings → API & Webhooks → + Create key** bölümünde bir API anahtarı oluşturun. Hemen kopyalayın — yalnızca bir kez gösterilir. Anahtarlar, erişebilecekleri alanları sınırlamak için **Settings → Members → Roles → Assignment** sekmesi altında belirli bir role bağlanabilir.
|
||
|
||
<VimeoEmbed videoId="928786722" title="API anahtarı oluşturma" />
|
||
|
||
OAuth tabanlı erişim (kullanıcılar adına hareket eden harici uygulamalar) için bkz. [OAuth](/l/tr/developers/extend/oauth).
|
||
|
||
## Toplu işlemler
|
||
|
||
Hem REST hem de GraphQL, istek başına 60 kayda kadar toplu işlemeyi destekler — oluşturma, güncelleme veya silme. GraphQL ayrıca `CreateCompanies` gibi çoğul adlar kullanarak toplu upsert'i (tek çağrıda oluşturma veya güncelleme) destekler.
|
||
|
||
## Hız sınırları
|
||
|
||
| Sınır | Değer |
|
||
| ------------ | --------------------- |
|
||
| İstekler | Dakikada 100 |
|
||
| Toplu boyutu | Çağrı başına 60 kayıt |
|