Dokümantasyon
Önizleme — buradaki SDK ve API örnek amaçlıdır, henüz genel kullanıma açık değildir.
Çoklu ajan API'leriyle geliştir.
Tek platform, tek kimlik doğrulama şeması, dört ürün yüzeyi. Her endpoint bir orkestratör çalıştırması — gözlemlenebilir, yeniden oynatılabilir ve panelden geri alınabilir.

Hızlı Başlangıç
İlk ajan çağrısına üç komut.
SDK'yı yüklersin, bir proje anahtarı belirlersin ve ilk orkestratör çalıştırmanı tetiklersin. CLI ilk çalıştırmada anahtarı bir ürün yüzeyine (Goddo, GoVista, GoPeople veya GoTrack) bağlamak için sana yol gösterir.
- Önce anahtar mı lazım? [email protected]'a yaz.
- TypeScript, Python ve Go için hazır SDK'lar.
- Her CLI komutu eşdeğer REST çağrısını yazdırır.
# 1. Install the SDK
npm install @gogogo/sdk
# 2. Authenticate with your project key
export GOGOGO_API_KEY="sk_live_…"
# 3. Run your first agent call
npx gogogo agent run goddo.image.generate \
--prompt "A neon GoBot delivering a parcel" \
--aspect 9:16POST https://api.gogogo.dev/v1/agents/run
Authorization: Bearer sk_live_…
Content-Type: application/json
{
"agent": "govista.schedule",
"tenant": "acme-retail",
"input": {
"campaign": "spring-launch",
"windows": ["weekday-am", "weekend"]
}
}REST API
Tek fiil. Çok uzman.
Neredeyse her işlem tek bir endpoint'ten geçer — /v1/agents/run — gövdede ajan adı ile. Orkestratör doğru uzmanı ve aracı seçer; cevap baştan sona yeniden oynatabileceğin bir trace_id taşır.
Orkestratör çalıştırmaları
Her API çağrısı bir orkestratör çalıştırmasıdır. Orkestratör hangi uzman ajanın hangi adımı işleyeceğine karar verir, araçları çağırır ve sonuç üretir.
Tenant ve kapsamlar
Kaynaklar tenant başına kapsamlanır. API anahtarları bir tenant öneki taşır; ürün ya da ortam başına alt anahtarlar oluşturabilirsin.
Idempotency
Herhangi bir POST'ta Idempotency-Key gönder. 24 saat içindeki yeniden denemeler ajanları tekrar çalıştırmak yerine orijinal çalıştırmayı döner.
Gözlemlenebilirlik
Her çalıştırma bir trace_id üretir. Panelden aç, her görev devrini, araç çağrısını ve kararı incele — oradan yeniden oynat ya da geri al.
Ürün yüzeyleri
Dört ürün, tek orkestratör.
Her ürün kendi endpoint'lerini /v1/<product>/… altında sunar. Şemalar stabildir; arkadaki orkestratör haftalık güncellenir.

Goddo
Görsel / video üretim API'si
Prompt gönder, render'ları rafine et, asset kütüphanesini al, tamamlanınca bildirim al.
- POST/v1/goddo/images
- POST/v1/goddo/refine
- GET/v1/goddo/library
- WEBHOOKgoddo.render.completed

GoVista
Dijital tabela CMS API'si
Cihaz kaydı, bölgeler arası oynatma listesi planlama ve audience-event telemetrisini veri ambarına akıt.
- POST/v1/govista/devices
- POST/v1/govista/playlists
- GET/v1/govista/zones
- WEBHOOKgovista.audience.event

GoPeople
WhatsApp İK API'si
WhatsApp Business numaralarını bağla, sınıflandırılmış niyetleri yönlendir, izin / belge iş akışlarını çalıştır, denetlenebilir kayıtlar.
- POST/v1/gopeople/threads
- POST/v1/gopeople/workflows
- GET/v1/gopeople/audit
- WEBHOOKgopeople.message.classified
GoTrack
Bilgisayarlı görü perakende API'si
Ürün alma olayları, FAISS benzerlik sorguları, askılık bölgesi skorlaması, canlı panel için imzalı pulse webhook'ları.
- POST/v1/gotrack/zones
- POST/v1/gotrack/similarity
- GET/v1/gotrack/score
- WEBHOOKgotrack.pickup.detected
Webhook'lar
İmzalı olaylar, yeniden oynatılabilir.
Her ürün kendi olay akışını yayar. Her teslim bir x-gogogo-signature HMAC, bir trace_id ve sabit bir olay adı taşır — product.entity.action. Başarısız teslimler üstel geri çekilme ile yeniden denenir ve panelden yeniden oynatılabilir.
- Örnekler: goddo.render.completed · govista.audience.event · gopeople.message.classified · gotrack.pickup.detected.
- İmzalama sırlarını ortam başına döndür. Doğrulama yardımcıları her SDK'da gelir.
// Verify a GOGOGO webhook with your signing secret.
import { verifyWebhook } from "@gogogo/sdk/webhooks";
export async function POST(req: Request) {
const ok = await verifyWebhook({
body: await req.text(),
signature: req.headers.get("x-gogogo-signature")!,
secret: process.env.GOGOGO_WEBHOOK_SECRET!,
});
if (!ok) return new Response("invalid signature", { status: 400 });
// …handle event…
}SDK'lar
Typed istemciler, OpenAPI'den üretilir.
OpenAPI spec'i tek doğru kaynaktır. SDK'lar her sürümde yeniden üretilir — biz dört paralel istemci kütüphanesini elle bakım yapmadan tip güvenliğin korunur.
- Stabil · v0.6
TypeScript / Node
npm install @gogogo/sdk
- Stabil · v0.5
Python
pip install gogogo-sdk
- Beta
Go
go get github.com/gogogollc/gogogo-go
- Daima güncel
OpenAPI spec
curl https://api.gogogo.dev/openapi.yaml
Destek
Belirli bir konuda mı takıldın?
Bize trace_id'ni ve çağırdığın endpoint'i gönder. Bir iş günü içinde yanıtlarız ve panelden her çalıştırmayı izliyoruz.