> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Developer hub: API sandbox, son istekler ve API belgeleri > Son Flowella API isteklerinizi görün, kuruluş genelindeki API sandbox'ı açın veya kapatın ve hızlı başlangıçları, etkileşimli API belgelerini, Postman ve OpenAPI'yi açın. Developer hub, [Flowella REST API](https://knowledge.flowella.io/tr/api-reference/introduction.md) üzerinde geliştirme yapmak için ihtiyacınız olanları bir araya getirir. API adresini, son API isteklerinin günlüğünü, kuruluş genelindeki **API sandbox** anahtarını, hızlı başlangıçları ve API belgelerine bağlantıları gösterir. Açmak için **Settings** bölümüne gidin, ardından **Developer** grubunda **Developer hub** seçeneğini seçin. ## Kimler kullanabilir | Hub'ın bölümü | Kimler kullanabilir | | - | - | | **API base URL**, **Quickstarts** ve **Links** | Kuruluştaki herkes. | | **Recent API requests** | Owner ve Admin kullanıcıları. Diğer roller için kart hiçbir istek göstermez. | | **API sandbox** | Herkes **Active** veya **Off** durumunda olduğunu görebilir. Yalnızca Owner ve Admin kullanıcıları açıp kapatabilir. | | Bağlantıların açtığı API anahtarları ve geliştirici uygulamaları | Owner ve Admin kullanıcıları. Bkz. [API anahtarları](https://knowledge.flowella.io/tr/settings/api-keys.md) ve [Geliştirici uygulamaları](https://knowledge.flowella.io/tr/settings/developer-apps.md). | ## API base URL Bu kart REST API'nin adresini gösterir. Kart `/api/v1` ile biten bir adres gösterse bile entegrasyonunuzda temel URL olarak `https://api.flowella.io/v1` kullanın. Nedeni için [Temel URL](https://knowledge.flowella.io/tr/api-reference/introduction.md#temel-url) bölümüne bakın. ## Recent API requests Bu kart, kuruluşunuza API anahtarları veya OAuth erişim belirteçleriyle yapılan en son 25 API isteğini en yeniden başlayarak listeler. | Sütun | Ne gösterir | | - | - | | **Time** | Flowella'nın isteği ne zaman aldığı. | | **Method** | HTTP yöntemi, örneğin `POST`. | | **Path** | Çağrılan uç nokta. | | **Status** | Flowella'nın döndürdüğü HTTP durumu. | | **Actor** | Çağrıyı kimin yaptığı: bir API anahtarı için `key:` ve ardından bir tanımlayıcı veya bir OAuth uygulaması için `oauth:` ve ardından istemci kimliği. `key:` tanımlayıcısı, API keys ekranında gösterilen anahtar öneki değildir. | | **Request id** | İsteğin kimliği; `X-Request-Id` yanıt başlığıyla aynı değer. | Flowella'nın çalıştırmadan önce reddettiği istekler listelenmez. Bunlar arasında eksik veya geçersiz belirteç, eksik kapsam, desteklenmeyen bir `API-Version` başlığı içeren ya da hız sınırını aşan istekler bulunur. Bir istekle bağlantılı her şeyi (neden olduğu olaylar, işler ve webhook teslimatları gibi) görmek için **Request id** ile `GET /v1/requests/{requestId}` çağrısı yapın. `account:read` kapsamı gerekir. Bkz. [İstek kimlikleri](https://knowledge.flowella.io/tr/api-reference/introduction.md#i̇stek-kimlikleri). ## API sandbox **API sandbox** kartında, WhatsApp'a hiçbir şey göndermeden test yapmak için kuruluş genelinde bir anahtar bulunur. Rozet, sandbox açıkken **Active**, kapalıyken **Off** gösterir. **Sandbox guide**, uygulamadaki sandbox kılavuzunu açar. Sandbox'ı açmak için bir Owner veya Admin kartın altındaki onay kutusunu işaretler. Sandbox'ı kapatmak için işareti kaldırın. Değişiklik tüm kuruluşa hemen uygulanır. Ayarı `{ "enabled": true }` veya `{ "enabled": false }` gövdesini kullanarak `GET /v1/sandbox` ve `PATCH /v1/sandbox` ile de okuyabilir ve değiştirebilirsiniz. Her ikisi de `sandbox:manage` kapsamını gerektirir. > [!WARNING] > > API sandbox, API çağrılarından fazlasını etkiler. Açıkken uygulamadaki [Toplu gönderim](https://knowledge.flowella.io/tr/app/bulk-send.md) ve HubSpot iş akışlarındaki **Send WhatsApp Template** eylemi de kişilere ulaşmayı durdurur. Gelen kutusundan gönderilen yanıtlar ile **Send WhatsApp Message** ve **Send WhatsApp Reply** HubSpot eylemleri yine gerçekten gönderilir. Test etmeyi bitirir bitirmez sandbox'ı kapatın. ### API sandbox ve sandbox anahtarları Sandbox'ı kullanmanın iki yolu vardır. Kuruluş genelindeki **API sandbox** her isteği kapsarken, bir [sandbox anahtarı](https://knowledge.flowella.io/tr/settings/api-keys.md#sandbox-anahtarları) yalnızca o anahtarla yapılan istekleri kapsar. | | Kuruluş genelindeki **API sandbox** | **Sandbox key** | | - | - | - | | Nasıl açılır | Bir Owner veya Admin buradaki anahtarı işaretler veya `PATCH /v1/sandbox` çağrısı yapar. | Bir API anahtarı oluştururken **Sandbox key** kutusunu işaretleyin. | | Hangi istekleri kapsar | Herhangi bir API anahtarından veya OAuth uygulamasından gelen, kuruluştaki tüm API istekleri. | Yalnızca o anahtarla yapılan istekler. | | `POST /v1/messages` | Flowella'da saklanır, gönderilmez. | Flowella'da saklanır, gönderilmez. | | Şablon gönderimi | Anında sahte karar. | Anında sahte karar. | | Şablon test gönderimleri | Atlanır. | Atlanır. | | `POST /v1/templates/send` | Alıcılar tamamlandı olarak kaydedilir, hiçbir şey gönderilmez. | Gerçekten gönderilir. | | Uygulamadaki **Bulk send** ve HubSpot **Send WhatsApp Template** eylemi | Alıcılar tamamlandı olarak kaydedilir, hiçbir şey gönderilmez. | Etkilenmez. | ### Sandbox'ta neler değişir Sandbox bir isteği kapsadığında: * `POST /v1/messages` mesajı konuşmada saklar ve `metaMessageId` değeri `null` olarak `"sandbox": true` döndürür. WhatsApp'a hiçbir şey ulaşmaz ve `message.sent` webhook'u tetiklenmez. * `POST /v1/templates/{id}/submit` ile şablon gönderimi Meta'ya ulaşmaz. Şablonu hemen onaylar veya şablon adı `reject_` içeriyorsa reddeder. Örneği yalnızca bir web adresi olan bir medya başlığı `400 INVALID_TEMPLATE_COMPONENTS` ile reddedilir. Karar API'de ve olay akışında görünür, ancak uygulamadaki **Templates** sayfası değişmez. * Sandbox gerçek kuruluşunuzda çalışır. Testler sırasında oluşturulan kişiler, konuşmalar ve mesajlar diğerleri gibi saklanır ve uygulamada görünür. ### Sandbox test araçları Bu uç noktalar etkinlik simüle etmenize yardımcı olur. `sandbox:manage` kapsamını gerektirirler ve sandbox açık olsun ya da olmasın çalışırlar, bu nedenle bunları yalnızca test verileriyle kullanın. | Yöntem | Yol | Ne yapar | | - | - | - | | `GET` | `/v1/sandbox/status` | API sandbox'ın açık olup olmadığını ve anahtarınızın bir sandbox anahtarı olup olmadığını belirten `sandboxKey` değerini döndürür. | | `POST` | `/v1/test/contacts` | `phone` ve isteğe bağlı `name` ile `email` değerlerinden bir kişi oluşturur veya günceller. | | `POST` | `/v1/test/messages/{id}/simulate-status` | Bir mesaj için olay akışına `message.sent`, `message.delivered`, `message.read`, `message.failed` veya `message.accepted` olayı ekler. `status` değerini `message.` öneki olmadan gönderin. | | `POST` | `/v1/test/webhooks/replay-event` | Olay akışına seçtiğiniz `type` türünde bir olay ekler. | | `POST` | `/v1/sandbox/fixtures/reset` | Sandbox olaylarını, sandbox işlerini ve sahte şablon kararlarını temizler. `POST /v1/test/reset` de aynısını yapar. | Test araçları yalnızca olay akışına (`GET /v1/events`) yazar. Webhook göndermez veya mesajın kendisini değiştirmez. ## Quickstarts **Quickstarts** kartı adım adım kılavuzlara bağlantı verir. Her biri yeni bir sekmede Markdown dosyası olarak açılır. | Hızlı başlangıç | Kapsadığı konular | | - | - | | Salesforce | OAuth yüklemesi, şablon gönderimi ve form alımı. | | Zoho CRM | Toplu kişi ekleme/güncelleme ve giden webhook'lar. | | SurveyMonkey | Anket ayrıntılarını eşleme ve gelen webhook'lar. | | Typeform | Typeform sağlayıcı akışları ve gelen webhook'lar. | | n8n | API'yi çağıran HTTP Request düğümleri. | ## Links | Bağlantı | Ne açar | | - | - | | **Interactive API docs** | İstek şemaları ve deneme örnekleriyle uygulamadaki API başvurusu. Test istekleri göndermek için bir API anahtarı yapıştırın. | | **Manage API keys** | Anahtar oluşturup iptal ettiğiniz [API anahtarları](https://knowledge.flowella.io/tr/settings/api-keys.md). | | **Developer apps** | OAuth uygulamalarını kaydettiğiniz [Geliştirici uygulamaları](https://knowledge.flowella.io/tr/settings/developer-apps.md). | | **OpenAPI JSON** | Postman'e, Insomnia'ya veya bir kod üreticisine aktarabileceğiniz API için OpenAPI belgesi. | | **Postman collection** | `flowella-v1.postman_collection.json` dosyasını indirir. | | **Capabilities matrix (authenticated)** | Belirtecinizin kapsamlarını, sandbox'ın açık olup olmadığını ve desteklenen mesaj türleri ile şablon kategorilerini listeleyen `GET /v1/capabilities`. `account:read` kapsamına sahip bir API anahtarı gerektirdiğinden, bir tarayıcı sekmesi kimlik doğrulama hatası gösterir. Bunun yerine API istemcinizden çağırın. | ## İlgili > **[API'ye giriş](https://knowledge.flowella.io/tr/api-reference/introduction.md)** > > Kimlik doğrulama, kapsamlar, hız sınırları ve hatalar. > **[API anahtarları](https://knowledge.flowella.io/tr/settings/api-keys.md)** > > Canlı ve sandbox anahtarları oluşturun. > **[Geliştirici uygulamaları](https://knowledge.flowella.io/tr/settings/developer-apps.md)** > > Bir OAuth uygulaması kaydedin ve yüklü uygulamaları yönetin. > **[Webhook başvurusu](https://knowledge.flowella.io/tr/api-reference/webhooks.md)** > > Olay türleri, yükler ve imza kontrolleri. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.