İçeriğe geç

REST API'ye bağlanın

API başvuru belgesinin nerede bulunduğu, kimlik doğrulamanın nasıl yapılacağı ve her isteğin uyduğu sınırlar ve kurallar.

4 dk okuma Gerçek ekranlar, kurgusal örnek veriler Güncellendi: 22 Ekim 2026

REST API, şirketinizin verilerine programlı erişim sağlar. Entegrasyon geliştiren geliştiriciler içindir; günlük kullanım için buna ihtiyacınız yoktur.

  • API başvuru belgesi: tam başvuru belgesi çalışma alanı adresinizde /docs/api adresinde herkese açıktır; OpenAPI belgesi /docs/api/openapi.yaml ve /docs/api/openapi.json adreslerindedir. Ayarlar'daki API ve webhook'lar buna bağlantı verir.
  • Temel URL: API ve webhook'lar sayfasının üstünde gösterilir. /api/v1 ile biter.
  • Kimlik doğrulama: Authorization: Bearer başlığını ardından token'ınızla ve Accept: application/json başlığını gönderin.
  • Yanıtlar: yalnızca JSON. Tekil kayıtlar data içine sarılır; listeler imleç tabanlı sayfalama için meta ve links ekler (limit ve cursor parametreleri, sayfa başına en fazla 100).
  • Güvenli yeniden denemeler: POST isteklerinde bir Idempotency-Key başlığı gönderin. Aynı isteği aynı anahtarla tekrarlamak, ikinci bir kayıt oluşturmak yerine saklanan yanıtı döndürür. Anahtarlar 24 saat saklanır.
  • Hız sınırı: token başına dakikada 120 istek. X-RateLimit-Limit ve X-RateLimit-Remaining başlıkları nerede olduğunuzu gösterir; sınırı aşarsanız Retry-After başlığıyla 429 alırsınız.

Bir istek neler yapabilir

Bir çağrı yalnızca token'ın yetkisi (örneğin invoices:write) ve token kullanıcısının uygulamada buna karşılık gelen izni olduğunda başarılı olur. Ekrandaki iş kurallarının aynısı geçerlidir; bu nedenle düzenlenmiş bir fatura API üzerinden de düzenlenemez.

Ürün hakkında sorun

Yazılımın neler yapabildiğini, bir işin nasıl yapıldığını veya hangi ülkeleri ve dilleri desteklediğini sorun. Yanıtlar bu kılavuzlardan gelir.

Düşünüyor…

Yapay zekâ asistanı şu anda kullanılamıyor. Kılavuzlarda arama yapın veya ekibimizle görüşün. Destekle iletişime geçin

Yapay zekâ hata yapabilir. Bağlantılı kılavuzları kontrol edin.

Hâlâ yardıma mı ihtiyacınız var?

Destek ekibimiz her mesajı okur ve sade bir dille yanıtlar.

Destekle iletişime geçin
Yapay zekâ ile sohbet