Ana içeriğe atla
Biri Sandbox olarak etiketlenmiş, yalnızca ad ve önekle listelenen iki anahtarı; oluşturulma ve son kullanım tarihlerini, Revoke eylemlerini ve Create key düğmesini gösteren API keys sayfası
Bir API anahtarı, betiklerinizin, kodsuz araçlarınızın ve arka uç hizmetlerinizin kuruluşunuz için Flowella REST API çağrısı yapmasını sağlar. Bu sayfa anahtarların nasıl oluşturulacağını, kullanılacağını, değiştirileceğini ve iptal edileceğini gösterir.

​
Başlamadan önce

  • Owner veya Admin rolüne ihtiyacınız vardır. Diğer roller menüde API keys öğesini görebilir, ancak liste onlar için yüklenmez. Bkz. Ekip ve roller.
  • Anahtarı nerede saklayacağınıza karar verin, örneğin bir sır yöneticisi veya aracınızın kimlik bilgisi deposu. Flowella tam anahtarı yalnızca bir kez gösterir.
Diğer Flowella müşterilerinin yükleyeceği bir uygulama mı geliştiriyorsunuz? API anahtarı yerine bir OAuth uygulaması kullanın. Bkz. OAuth ile bir iş ortağı uygulaması kaydedin.

​
API anahtarı oluşturun

1

API keys sayfasını açın

Settings bölümüne gidin, ardından Developer grubunda API keys seçeneğini seçin.
2

Yeni bir anahtar başlatın

Create key seçeneğini seçin. Create API key iletişim kutusu açılır.
3

Anahtarı adlandırın

Name alanına anahtarın nerede kullanıldığını belirten bir şey girin, örneğin n8n production. Adlar en fazla 120 karakter olabilir. Flowella adı yalnızca bu listede gösterir. Ad API istekleriyle birlikte gönderilmez.
4

Canlı veya sandbox anahtarı seçin

Canlı bir anahtar için Sandbox key kutusunu işaretlemeden bırakın. WhatsApp’a hiçbir zaman bir şey göndermeyen bir anahtar için işaretleyin. Bkz. Sandbox anahtarları.
5

Anahtarı oluşturun ve kopyalayın

Create seçeneğini seçin. Save your API key iletişim kutusu tam anahtarı gösterir. Copy seçeneğini seçin, anahtarı saklayın, ardından Done seçeneğini seçin.
Flowella tam anahtarı yalnızca bir kez gösterir ve yeniden gösteremez. Kaybederseniz anahtarı iptal edin ve yenisini oluşturun. Anahtarlara parola gibi davranın: onları asla kaynak denetimine eklemeyin veya sohbete ya da paylaşılan belgelere yapıştırmayın.

​
Bir anahtar neler yapabilir

Uygulamada bir anahtarı bazı kapsamlarla sınırlayamazsınız. Bir entegrasyonun daha dar bir erişime sahip olması gerekiyorsa, yalnızca ihtiyaç duyduğu kapsamlarla bir OAuth uygulaması kaydedin.

​
Bir anahtarı kullanın

Anahtarı her isteğin Authorization başlığında bir bearer belirteci olarak gönderin. Bir anahtarın çalıştığını kontrol etmek için ping uç noktasını çağırın:
"ok": true içeren bir 200 yanıtı, anahtarın geçerli olduğu anlamına gelir. Anahtarı yapıştırıp istekleri deneyebileceğiniz etkileşimli API başvurusunu açmak için ekranın üst kısmındaki View API docs seçeneğini seçin.

​
Sandbox anahtarları

Bir sandbox anahtarı, WhatsApp’a hiçbir şey göndermeden bir entegrasyonu test etmenizi sağlar. Bir sandbox anahtarıyla yapılan istekler şöyle davranır:
  • POST /v1/messages mesajı Flowella’da saklar ve metaMessageId değeri null olarak "sandbox": true döndürür. WhatsApp’a hiçbir şey ulaşmaz.
  • Şablon gönderimi şablonu hemen onaylar veya şablon adı reject_ içeriyorsa reddeder. Meta onu hiç görmez.
  • Şablon test gönderimleri atlanır.
Bir sandbox anahtarı, POST /v1/templates/send üzerinden yapılan toplu gönderimleri durdurmaz. Bu mesajlar gerçekten gönderilir. Toplu gönderimleri güvenle test etmek için bunun yerine Developer hub içinde kuruluş genelindeki API sandbox seçeneğini açın. Açıkken uygulamadan yapılan toplu gönderimler de atlanır.
Sandbox anahtarları gerçek kuruluşunuz üzerinde çalışır. Oluşturdukları kişiler, konuşmalar ve mesajlar diğerleri gibi saklanır ve uygulamada görünür. Sandbox anahtarları listede adlarının yanında bir Sandbox rozeti gösterir.

​
API anahtarları listesi

Bir anahtarın son zamanlarda hangi çağrıları yaptığını görmek için Developer hub içinde Recent API requests bölümünü açın.

​
Bir anahtarı iptal edin

  1. Listede anahtarın satırındaki Revoke seçeneğini seçin.
  2. Revoke this API key? It will stop working immediately. istemini onaylayın.
Bundan sonra anahtarı kullanan istekler 401 ve Invalid or expired API key mesajıyla başarısız olur. Satır listede bir Revoked rozetiyle kalır. İptali geri alamazsınız: yeniden erişime ihtiyacınız olursa yeni bir anahtar oluşturun.

​
Bir anahtarı değiştirin

Döndürme düğmesi yoktur. Bir anahtarı kesinti olmadan değiştirmek için:
  1. Açık bir adla yeni bir anahtar oluşturun, örneğin n8n production 2026.
  2. Entegrasyonunuzu yeni anahtarı kullanacak şekilde güncelleyin.
  3. Yeni anahtarın Last used zamanının değiştiğini kontrol edin.
  4. Eski anahtarı iptal edin.

​
Sorun giderme

API anahtarlarını yalnızca Owner ve Admin kullanıcıları görüntüleyip yönetebilir. Bir Owner veya Admin’den anahtarı sizin için oluşturmasını isteyin. Roller uygulamada değiştirilemez: bkz. Birinin rolünü değiştirin.
Başlığın tam olarak Authorization: Bearer ve ardından anahtarın içinde boşluk veya satır sonu olmadan tam anahtar olduğunu kontrol edin. Invalid or expired API key mesajı, anahtarın iptal edildiği veya yanlış yazıldığı anlamına gelir. Missing bearer token, başlığın ulaşmadığı anlamına gelir: bazı HTTP istemcileri bir yönlendirmeyi izlerken başlığı düşürür, bu nedenle doğrudan https://api.flowella.io/v1 adresini çağırın.
Hemen iptal edin, ardından bir yedek oluşturun ve entegrasyonunuzu güncelleyin. Tanımadığınız çağrılar için Developer hub içindeki Recent API requests bölümünü kontrol edin.

​
İlgili

API'ye giriş

Kimlik doğrulama, kapsamlar, hız sınırları ve hatalar.

Developer hub

Son API istekleri, API sandbox ve hızlı başlangıçlar.

Geliştirici uygulamaları

Diğer kuruluşlar uygulamanızı yüklediğinde OAuth kullanın.

Webhook'lar

API’yi yoklamak yerine olayları alın.
Son değiştirilme tarihi 24 Ekim 2026