Geliştirici ayarları, Exayard'ı kendi kodunuza ve diğer şirketlerin geliştirdiği uygulamalara bağladığınız yerdir. Ayarlar ve ardından Geliştirici bölümünü açın. Bu bölümü Ayarlar menüsünde yalnızca şirket yöneticileri görür. Sayfayı açan bir üye içeriği okuyabilir ancak hiçbir şeyi değiştiremez.

Uygulamalar, API anahtarları, webhook'lar ve günlükler Ücretsiz dahil her planda sunulur. Yalnızca yapay zekâ işleri ücretlendirilir.

Uygulama, "Acme estimator" veya "Nightly sync" gibi entegrasyonlarınızdan biridir. Her API anahtarı bir uygulamaya aittir. Uygulamalar, sayfadaki ilk bölümdür. Her üye bu bölümü okuyabilir. Uygulamaları yalnızca yöneticiler oluşturur veya değiştirir.

Yeni uygulama'ya tıklayın ve Ad, Açıklama, Ana sayfa, Destek e-postası ve Kapsamlar alanlarını doldurun. Kapsamlar, read:projects ve write:estimates gibi her kaynak için okuma ve yazma olarak ayrılır. Uygulamalar admin:org kapsamını isteyemez. Bir şirketin en fazla 25 uygulaması olabilir.

Her uygulama, ne zaman oluşturulduğunu ve "Şirket başına dakikada en fazla 60 istek, toplamda 600" gibi istek limitini gösterir. Uygulamanın Diğer işlemler menüsünde şunlar bulunur:

API anahtarı, kendi kodunuzun Exayard API'sini çağırmasını sağlar. Anahtarlar bir uygulamanın içinde, Anahtarlar altında bulunur. Bir anahtar kendi uygulamasının şirketinde çalışır; bu nedenle ayrıca bir şirket kimliği göndermeniz gerekmez.

Anahtar oluşturmak için uygulamada Yeni anahtar'a tıklayın. Anahtara "Production" gibi bir Ad verin. Kapsamlar altında, uygulamanın sahip olduğu tüm kapsamlar için Tümü'nü, daha azını seçmek için Belirli'yi seçin. Anahtar kısa süreli bir iş içinse isteğe bağlı bir Bitiş tarihi belirleyin. Anahtar o günün sonuna kadar çalışır. Oluştur'a tıklayın.

Exayard tam anahtarı yalnızca bir kez gösterir. Bir daha gösterilmeyeceği için anahtarı o anda kopyalayın. Exayard anahtarın yalnızca şifrelenmiş bir kopyasını saklar; bu nedenle kaybolan bir anahtar kurtarılamaz. Yeni bir anahtar oluşturun ve eskisini iptal edin.

Anahtar exa_live_ ile başlar. Bir sandbox içinde oluşturulan anahtar ise exa_test_ ile başlar. Oluşturduktan sonra anahtar; adını, exa_live_...AbCd gibi bir önizlemeyi ve Son kullanım veya Hiç kullanılmadı bilgisini gösterir. Bitiş tarihi olan bir anahtar Bitiş tarihi ve tarihini, süresi dolmuş bir anahtar ise Süresi doldu ifadesini gösterir.

Bir uygulamanın en fazla 25 etkin anahtarı olabilir. Süresi dolmuş bir anahtar, siz iptal edene kadar bu sayıya dahil olmaya devam eder. Anahtarları kesinti olmadan değiştirmek için ikinci bir anahtar oluşturun, sunucularınızı ona geçirin, ardından ilkini iptal edin.

Bir anahtarı Yeniden adlandırmak veya İptal etmek için Anahtar işlemleri menüsünü açın. İptal etme işlemi geri alınamaz ve anahtar 30 saniye içinde çalışmayı durdurur.

Bir anahtar, herkese açık bir kod deposu gibi herkese açık bir yerde ortaya çıkarsa Exayard anahtarı iptal eder, yöneticilerinize e-posta gönderir ve anahtarı listede Herkese açık ortamda bulundu, iptal edildi olarak işaretli şekilde tutar.

Uygulamanızı başka bir şirket yüklediğinde, yeni anahtar iletişim kutusunda Çalıştığı yer seçeneği de görünür. Varsayılan seçenek Bu şirket'tir. Uygulamayı yükleyen tüm şirketler, sunucunuzun bu şirketlerin her birinde kullandığı bir anahtar oluşturur. Bu durumda her çağrı, şirketini Exayard-Organization-Id başlığında belirtir.

Aynı anahtarlar kodsuz araçları da bağlar. Exayard'ı Zapier'e bağlama, Exayard'ı Make'e bağlama ve Exayard'ı n8n'e bağlama makalelerine bakın. Yapay zekâ asistanları için Exa'yı yapay zekâ asistanınıza bağlama makalesine bakın.

Anahtarların uygulamalar içinde yer almasından önce oluşturulan anahtarlar ak_ ile başlar. Bu anahtarlar çalışmaya devam eder, ancak yenileri oluşturulamaz. Sayfanın en altındaki Eski anahtarlar bölümünde, yalnızca böyle anahtarlar olduğu sürece görünürler.

Her yönetici, kimin oluşturduğundan bağımsız olarak şirketin tüm anahtarlarını burada görür. Başka birinin oluşturduğu bir anahtarda Oluşturan ve o kişinin adı gösterilir. Herkes kendi kişisel anahtarlarını da görür. Bir anahtarı İptal etmek için çöp kutusu simgesine tıklayın. Anahtar anında çalışmayı durdurur.

Sandbox, şirketinize bağlı bir test şirketidir. Gerçek projelerinize dokunmadan bir entegrasyon oluşturmak ve test etmek için kullanın. Sandbox'lar bölümünü yalnızca yöneticiler görür.

Yeni sandbox'a tıklayın, bir Ad verin ve Oluştur'a tıklayın. Bir şirketin en fazla 5 sandbox'ı olabilir. Aç sizi sandbox'a geçirir; şirket değiştiricide sandbox Sandbox olarak işaretlenir. Orada her zamanki gibi bir uygulama ve anahtar oluşturun. Anahtarları exa_test_ ile başlar. Canlıya geçmek için aynı uygulamayı ve anahtarı gerçek şirketinizde oluşturun ve kodunuzdaki anahtarı değiştirin.

Sandbox şirketinizin planını izler ve kullanımının ücretini şirketiniz öder. Kendine ait bir faturalandırması yoktur ve kendine ait aylık yapay zekâ kullanımı almaz. Webhook'lar ve entegrasyonlar gerçek şirketinizde olduğu gibi çalışır.

Sandbox, dışarıdaki kişilere teklif paylaşım e-postaları veya imzalı kopyalar göndermez ve kısa mesaj da göndermez. Bunlar "Bu şirket bir sandbox olduğu için gönderilmedi" olarak görünür. Sandbox'a katılma davetleri her zamanki gibi gönderilir.

Sandbox'taki metrajlar ve dosya okumaları, örnek projemizden kopyalanan sonuçları ücretsiz olarak döndürür. Metraj, sayfaları ve metraj tamamlandığında gönderilen webhook örnek olarak işaretlenir. Keşifler, teklifler, öğe arama ve sohbet de ücretsiz olarak örneklerle yanıt verir.

Bir sandbox'ı kaldırmak için satırındaki Sil'e, ardından Sandbox'ı sil'e tıklayın. Sandbox kapatılır, anahtarları çalışmayı durdurur ve verileri daha sonra silinir.

Webhook, şirketinizde bir şey gerçekleştiğinde Exayard'ın sunucunuzu bilgilendirmesini sağlar. Her üye listeyi okuyabilir. Webhook'ları yalnızca yöneticiler ekler veya değiştirir.

Webhook oluştur'a tıklayın, gönderimleri alacak URL'yi girin ve isteğe bağlı bir Açıklama ekleyin. Hangi Olayların gönderileceğini seçin. Yeniler dahil tüm olayları almak için Tümü'nü, listeden seçim yapmak için Belirli'yi seçin. Tüm olaylar ve içerikleri webhook olay kataloğunda listelenir.

Bir webhook oluşturduğunuzda Exayard, İmzalama gizli anahtarı'nı yalnızca bir kez gösterir. Bir daha gösterilmeyeceği için o anda kopyalayın.

Diğer her şey için webhook'un Diğer işlemler menüsünü açın:

Test olayları ve yeniden gönderimler bir kez gönderilir ve hiçbir zaman yeniden denenmez.

Her gönderim, t=<unix>,v1=<digest> biçiminde bir Exayard-Signature başlığı taşır. Exayard imzayı, zaman damgasını ve istek gövdesini birleştirip bunları webhook'unuzun gizli anahtarıyla HMAC-SHA256 kullanarak imzalayarak oluşturur.

Her gönderim ayrıca Exayard-Event-Id, Exayard-Event-Type ve Exayard-Organization-Id başlıklarını da taşır. JSON gövdesinde, olayın hangi şirketten geldiğini belirten bir organizationId alanı bulunur. Başlık da aynı kimliği taşır; böylece gövdeyi okumadan önce gönderimi yönlendirebilirsiniz. İmza, organizationId dahil olmak üzere gövdenin tamamını kapsar.

Her gönderim kendi şirketini belirttiği için tek bir alıcı adresi birçok şirkete hizmet verebilir. Aynı URL'yi her şirkette kaydedin ve her gönderimi organizationId değerine göre yönlendirin. Her webhook'un kendi gizli anahtarı vardır; bu nedenle doğrulamadan önce gizli anahtarı Exayard-Organization-Id değerine göre seçin.

Bir gönderimi doğrulamak için imzayı gizli anahtarınızla yeniden hesaplayın, zaman damgasının şu andan itibaren beş dakika içinde olduğunu kontrol edin ve özetleri karşılaştırın.

Başarısız bir gönderim, denemeler arasındaki bekleme süreleri giderek uzayacak şekilde yaklaşık 80 saat boyunca toplamda en fazla 10 kez denenir. Her denemede aynı gövde ve aynı olay kimliği gönderilir. Yönlendirme başarısızlık olarak sayılır.

Uygulamanız, oluşturduğunuz anda kendi şirketinizde çalışır. Her uygulamada ayrıca bir Diğer şirketlerin bu uygulamayı yüklemesine izin verin bölümü bulunur. Bu bölüm uygulamanın İncelendi, İnceleme istendi veya İncelenmedi durumunu, Oturum açma adresleri'ni, İstemci kimliği'ni ve kaç şirketin uygulamayı yükleyebileceğini gösterir.

Yöneticiler bunlar için Yükleme işlemleri menüsünü açar:

Yeni bir uygulama, kendi şirketiniz dışında en fazla 25 şirkete yüklenebilir ve Uygulama bul içinde görünmez. Müşterileriniz için hesaplar altındaki şirketler bu limite dahil edilmez. Onaylandıktan sonra uygulamada İncelendi görünür ve yükleme limiti kaldırılır. Uygulamayı her şirketin dizininde listelemek için Uygulama bul ekranında göster'i, listeden çıkarmak için Uygulama bul ekranından gizle'yi kullanın. Askıya alındı durumundaki bir uygulama, destek ekibi askıya almayı kaldırana kadar Exayard'ı çağıramaz; yüklemeleri ise korunur.

Bir uygulamadan kapsam kaldırdığınızda, tüm yüklemeler bu kapsamları anında kaybeder. Kapsam eklediğinizde ise her şirket, yöneticilerinden biri yeni kapsamları onaylayana kadar mevcut erişimini korur.

Uygulamanın Diğer işlemler menüsünü açın ve Webhook'a tıklayın. URL'yi girin ve Oluştur'a tıklayın, ardından Exayard'ın yalnızca bir kez gösterdiği İmzalama gizli anahtarı'nı kopyalayın. Uygulamayı yükleyen her şirket, verdiği kapsamların kapsadığı olayları gönderir. Uygulamanız ayrıca bir şirket onu yüklediğinde, daha geniş erişimi onayladığında veya kaldırdığında app.installed, app.scopes_approved ve app.uninstalled olaylarını alır. Gönderimler kendi şirketlerini belirtir ve diğer webhook'larla aynı şekilde imzalanır.

Aynı iletişim kutusu, gönderimleri Duraklat ve Sürdür ile durdurup yeniden başlatmanıza, Gizli anahtarı yenile ile anahtarı yenilemenize ve Webhook'u sil ile webhook'u silmenize olanak tanır.

Bağlı uygulamalar, şirketinizde yüklü olan uygulamaları listeler. Her üye bu listeyi görebilir. Uygulamaları yalnızca yöneticiler yükler, kaldırır veya onaylar.

Her satırda uygulamanın adı, İncelendi olup olmadığı, onu geliştiren şirket, kimin ve ne zaman yüklediği ve verilen kapsamlar gösterilir.

Uygulamanın yükleme bağlantısını açın veya Uygulama bul içinde uygulamanın yanındaki Yükle'ye tıklayın. İletişim kutusu, uygulamayı kimin geliştirdiğini, incelenip incelenmediğini ve istediği kapsamları gösterir. Ardından şunları seçin:

Yükle'ye tıklayın. Uygulama sizi oturum açtırıyorsa Exayard ardından sizi uygulamada oturum açmayı tamamlamaya yönlendirir. Yönetici değil de üyeyseniz iletişim kutusu, uygulamayı hangi şirketin yöneticisinin yükleyebileceğini söyler. Bağlantıyı onlara göndermek için Bağlantıyı kopyala'ya tıklayın.

Projeleri daha sonra değiştirmek için yükleme bağlantısını yeniden açın ve yeni seçiminizle yükleyin.

Bir uygulama daha fazla kapsam istediğinde, satırında yeni kapsamlarla birlikte Daha fazla erişim istiyor ifadesi görünür. Bir yönetici bunları vermek için Onayla'ya tıklar. O zamana kadar uygulama mevcut erişimini korur.

Uygulamanın Diğer işlemler menüsünü açın, Kaldır'a tıklayın ve onaylayın. Uygulama şirketinize erişimini anında kaybeder ve webhook'ları durur. Daha önce başlattığı yapay zekâ işleri yine de tamamlanır.

Uygulama bul, Bağlı uygulamalar içinde görünür. Geliştiricilerinin listelemeyi seçtiği incelenmiş uygulamaları listeler. Şirketinizin zaten sahip olduğu bir uygulamada Yüklü yazar. Yükleme iletişim kutusunu açmak için başka herhangi bir uygulamada Yükle'ye tıklayın.

Kişisel bağlantılarınız, kendi Exayard hesabınıza bağladığınız ChatGPT veya Claude gibi yapay zekâ araçlarını ve diğer uygulamaları listeler. Bağlı uygulamalar bölümünün en üstünde görünür ve kendi bağlantılarınızı yalnızca siz görürsünüz. Kişisel bir bağlantı sizin adınıza hareket eder; bu nedenle sizin erişebildiğiniz her şeye erişebilir.

Her bağlantı, ilk ve son ne zaman kullanıldığını ve hangi şirketlerde kullanıldığını gösterir. Bir bağlantıyı durdurmak için Diğer işlemler menüsünü açın, Kaldır'a tıklayın ve onaylayın. Bağlantının bir sonraki çağrısı reddedilir. Bağlantı listede Kaldırıldı olarak işaretli şekilde kalır ve Yeniden izin ver ile tekrar erişim verilebilir. Yeni bir araç bağlamak için Exa'yı yapay zekâ asistanınıza bağlama makalesine bakın.

Uygulamanız, Exayard'ı yalnızca sizin ürününüz üzerinden kullanan müşteriler için API aracılığıyla Exayard şirketleri oluşturabilir. Bu şirketlerin sahibi sizin şirketinizdir ve bu şirketlerde yapılan yapay zekâ işlerinin ücretini sizin şirketiniz öder. Bu şirketlerin kendi üyeleri yoktur ve uygulamalarınız bu şirketlere otomatik olarak yüklenir.

Müşterileriniz için hesaplar, bu şirketleri yöneticiler için listeler; her şirketin Ad bilgisi ve Oluşturulma tarihi gösterilir. Bir şirketi kapatmak için Bırak'a tıklayın ve onaylayın. Şirketteki tüm uygulamalar erişimini kaybeder.

Hızlı başlangıç kartı, Claude veya Cursor gibi bir yapay zekâ düzenleyicisi için hazır bir istem içerir. İstemi kopyala'ya tıklayın ve istemi düzenleyicinize yapıştırın. İstem; API temel URL'sini, kimlik doğrulama biçimini, kapsamları ve webhook imzalama düzenini içerir. Böylece yapay zekâ çalışan bir entegrasyon oluşturabilir ve ihtiyaç duyduğu ayrıntıları size sorabilir. Bu kartı yalnızca yöneticiler görür, çünkü bir API anahtarı gerektirir.

Dokümantasyon kartı, Dokümantasyonu aç ile tüm geliştirici dokümantasyonuna ve her rotayı ve şemayı açıklayan OpenAPI belirtimi'ne bağlantı verir. Yöneticiler ayrıca yapay zekâ asistanlarını Exayard'a bağlama kurulumunu açan Claude veya Cursor'a bağlan seçeneğini de görür.

Günlükler, API'ye yapılan istekleri en yeniden başlayarak gösterir. Her satırda Yöntem, Yol, Durum, Zaman ve Gecikme gösterilir. Daha eski istekleri görmek için en alttaki Daha fazla yükle'ye tıklayın.

Yöneticiler tüm istekleri görür. Üyeler yalnızca bir uygulama üzerinden gelmeyen istekleri görür.

Yöneticiler Uygulama'ya, ardından o uygulamanın anahtarlarından birine göre filtreleme yapabilir. Herkes yalnızca o müşterinin isteklerini görmek için bir Son kullanıcı yazabilir. Son kullanıcı, müşterilerinizden biri için kullandığınız kendi kimliğinizdir. Kodunuz bunu her istekle birlikte Exayard-End-User başlığında gönderir. Kimlik olarak asla bir e-posta adresi kullanmayın.

İstek kimliği, uygulama ve son kullanıcı ile İstek gövdesi ve Yanıt gövdesi dahil tüm ayrıntıları görmek için bir satırı seçin. Bir çağrının çalıştığını doğrulamak veya bir entegrasyonun neden başarısız olduğunu bulmak için günlükleri kullanın.

Yöneticiler, her uygulamanın bu ay ne kadar harcadığını Ayarlar ve ardından Kullanım altındaki Uygulamaya göre harcama bölümünde görür. Kendi uygulamalarınız da burada listelenir. Her uygulamanın altında Anahtara göre, her anahtarın ne kadar harcadığını; En çok harcayan son kullanıcılar ise en çok harcayan beş son kullanıcıyı gösterir. Uygulamanın anahtarlarından birine bağlı olmayan harcamalar Diğer olarak görünür.

Bir uygulamanın aylık yapay zekâ limiti, uygulamanın yapay zekâ işlerinin her fatura ayında şirketinize en fazla ne kadara mal olabileceğidir. Limiti belirlemek için Uygulamaya göre harcama altında uygulamanın Diğer işlemler menüsünü açın ve Aylık yapay zekâ limitini belirle'ye tıklayın. Fatura para biriminizde bir tutar girin ve Kaydet'e tıklayın. Limiti kaldırmak için alanı boş bırakıp kaydedin.

Uygulama limitine ulaştığında, şirketinizin hâlâ yapay zekâ kullanımı kalmış olsa bile uygulamanın yapay zekâ işleri fatura ayının geri kalanında reddedilir. Şirketinizin kendi limitleri de geçerli olmaya devam eder. Kişilerin kendilerinin başlattığı yapay zekâ işleri hiçbir zaman bir uygulamanın limitine sayılmaz.