Geliştiriciler için

Cyzyra sistemlerinizde. Ve Cyzyra'daki sistemleriniz.

REST API, imzalı web kancaları ve yapay zeka asistanlarına bağlantı. Şirket verilerini ERP, BI veya kendi uygulamanıza taşımak.

Belgeleri okuyun API platformunu açın

curl https://YOUR-PAINEL/api/v1/leads?limit=20 \ -H "Yetkilendirme: Taşıyıcı cy_live_..."

{ "data": [{ "id": "…", "name": "…", "status": "new" }], "next_cursor": null }

Çağrı ve yanıtın açıklayıcı örneği.

01 / Entegrasyonun üç yolu

Okuyun, alın ve sorun.

Birini, ikisini veya üçünü birden kullanın. Hepsi anahtarın izinlerine ve ona sahip olan şirketin verilerine saygı duyuyor.

REST API'si
OpenAPI belgeleriyle JSON'da potansiyel müşteriler, pazarlıklar, ödemeler, nesneler ve ölçümler.
Web kancaları
Abonelikle 18 şirket etkinliği sisteminize anında gönderilir.
Yapay Zeka Asistanları (MCP)
Cyzyra'yı MCP uyumlu yapay zeka asistanlarına bağlayın ve satış, reklam ve kâr hakkında bilgi alın.

02 / REST API'si

Uç noktalar

Kimlik doğrulaması: Yetki: Taşıyıcı, JSON yanıtları ve imleç sayfalandırması.

Anahtar başına dakikada 120 istek
Anahtar yalnızca karma olarak depolanır

GET/api/v1/leadsPotansiyel müşterileri listeleme ve arama
POST/api/v1/leadsBir müşteri adayı oluşturun (yinelenen kontrolle)
GET/api/v1/leads/{id}Ayrıntıları içeren bir ipucu
PATCH/api/v1/leads/{id}Potansiyel müşteriyi güncelleme
GET/api/v1/dealsMüzakereler ve huni aşamaları
POST/api/v1/dealsTicaret oluştur
GET/api/v1/paymentsFaturalar ve ödemeler
GET/api/v1/objectsNesne türleriniz
GET/api/v1/objects/{type}/recordsBir nesne türünün kayıtları
POST/api/v1/objects/{type}/recordsKayıt oluştur
POST/api/v1/queryFiltreler ve dönemler içeren metrikler
POST/api/v1/askVerilerle ilgili Portekizce soru

03 / Web Kancaları

Şirkette oldu, sisteminize geldi.

Etkinlikleri ve adresi seçin. Her gönderim imzalanır ve başarısız olan gönderimler 5 defaya kadar yeniden gönderilir.

Yeniden gönderime karşı zamanla HMAC imzası
Kontrol panelindeki her denemenin geçmişi

// Cabeçalho: X-Cyzyra-Signature: t=1731000000,v1=<hmac>
const [t, v1] = header.split(",").map((p) => p.split("=")[1]);
const esperado = hmacSha256(segredo, `${t}.${corpoBruto}`);
if (esperado !== v1) throw new Error("assinatura inválida");

18 mevcut etkinlikler

Lead criadolead.created
Status do lead mudoulead.status_changed
Cadastros unificadoslead.merged
Negociação criadadeal.created
Negociação mudou de etapadeal.stage_changed
Venda ganhadeal.won
Venda perdidadeal.lost
Teklif gönderildiproposal.sent
Teklif kabul edildiproposal.accepted
Proposta recusadaproposal.rejected
Sözleşme gönderildicontract.sent
Contrato assinadocontract.signed
Ödeme oluşturuldupayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received

04 / Yapay Zeka Asistanları

Asistanınızın içinden Cyzyra'ya sorun.

API anahtarınızla Cyzyra'nın MCP adresini uyumlu bir AI asistanına özel bağlayıcı olarak ekleyin. Kâr, kampanyalar ve satışlar konusunda danışmanlık yapmaya başlıyor ve verileriyle ilgili soruları Portekizce yanıtlıyor.

URL: https://SEU-PAINEL/api/mcp Başlık: Yetkilendirme: Bearer cy_live_... Araçlar: Summary_profit · kampanyalar · satış talebi · Manage_campaigns (yazma)

05 / Sorular

Teknik sorular

Hazır entegrasyonları görüntüleyin

API anahtarını nerede oluşturabilirim?+

API Platformu panosunda (menü Sistem → API Platformu → API Anahtarları). Anahtar yalnızca bir kez görünür; Cyzyra bunun yalnızca şifrelenmiş bir versiyonunu saklar.

Bir anahtarın hangi izinleri olabilir?+

Okumak ya da okuyup yazmak. MCP bağlantısı üzerinden potansiyel müşteri oluşturma veya kampanyaları değiştirme gibi işlemler, yazma izni gerektirir.

Kullanım sınırı var mı?+

Evet: Anahtar başına dakikada 120 istek. Bunun üzerinde, API 429 yanıtını verir ve kaç saniye içinde yeniden denemeniz gerektiğini size söyler.

Bir web kancası kapandığında sistemim çökerse ne olur?+

Cyzyra, artan aralıklarla 5 defaya kadar yeniden dener ve her denemeyi kontrol panelinde görüntüler.

Her anahtar kimin verilerini görüyor?+

Yalnızca anahtarı oluşturan şirketten. Diğer şirketlerin verileri hiçbir zaman görünmez.

Hesabınızı oluşturun ve ilk anahtarınızı bugün oluşturun.

Için ilk ay US$ 10,00, tam erişime sahip. Daha sonra planı seçersiniz.

Şunun için başla: US$ 10,00

Bir kişiyle konuşmayı mı tercih edersiniz? Ekiple konuşun

İptal etmenin herhangi bir cezası yoktur · Garanti 30 dias

Açıklayıcı örnek