Synthory Developer Platform

API Dokümantasyonu

Synthory API; üyelik, paket/kredi, Özellik Merkezi, modül çıktıları, AI sağlayıcıları, destek, YouTube operasyonları ve canlı destek asistanı akışlarını yönetmek için tasarlanmıştır.

Base URL: https://amele.usFormat: JSON / Form POSTAuth: Session + Workspace API KeyGüvenlik: Maskeli/şifreli secret yönetimi

Genel Bakış

Synthory API, medya operasyonlarını ürünleştirmek isteyen ekipler için üç ana katmanda çalışır: müşteri hesabı ve paket/kredi yönetimi, içerik/otomasyon modülleri, entegrasyon ve destek akışları.

Üye katmanı

Dashboard, paket, kredi, API anahtarı, AI sağlayıcıları ve destek talepleri.

Operasyon katmanı

AI Studio, Özellik Merkezi, modül çıktıları, YouTube hesapları ve otomasyon merkezi.

Entegrasyon katmanı

Workspace API keys, WordPress Connector, canlı destek widget ve provider API ayarları.

Kimlik Doğrulama

Web panel akışları güvenli session cookie ile çalışır. Programatik entegrasyonlar için üye panelinden oluşturulan Workspace API anahtarları kullanılır.

Authorization: Bearer syn_xxxxxxxxxxxxxxxxx
Content-Type: application/json

API anahtarının tamamı sadece oluşturulduğu anda gösterilir.
Panelde anahtarlar maskeli görünür.
İptal edilen anahtar tekrar kullanılamaz.
Kullanıcı AI provider anahtarları AES-256-GCM ile şifreli saklanır.

Standart Hata Yaklaşımı

HTML panel route’ları kullanıcı dostu sayfa döndürür. JSON endpointler aşağıdaki mantıkla cevap verir:

{
  "ok": false,
  "error": {
    "code": "insufficient_credits",
    "message": "Bu işlem için kredi bakiyesi yeterli değil.",
    "requestId": "req_..."
  }
}

Not: Güvenlik nedeniyle secret/token/cookie/şifre değerleri hata mesajlarında gösterilmez.

Endpoint Kataloğu

Metod	Path	Amaç	Notlar
GET	`/health`	Platform sağlık kontrolü	Kimlik doğrulama gerektirmez. İzleme sistemleri için 200 OK döner.
POST	`/register`	Yeni üyelik oluşturma	Ad, e-posta ve şifre ile Starter paket kullanıcı oluşturur.
POST	`/login`	Oturum açma	E-posta/şifre doğrular ve güvenli session cookie üretir.
GET	`/dashboard`	Operasyon dashboard	Üye oturumu gerekir. Paket, kredi, kanal, iş ve upload özetlerini gösterir.
GET	`/feature-center`	Özellik Merkezi	Paket erişimine göre modül/özellik kataloğunu listeler. q parametresiyle arama yapılır.
POST	`/feature/{featureId}`	Modül çalıştırma	Kredi/paket kontrolü yapar, iş kaydı ve Modül Çıktısı üretir.
GET	`/outputs`	Modül çıktıları	Çalıştırılan modüllerin rapor, plan ve kontrol listelerini döndürür.
GET	`/api-keys`	Workspace API anahtarları	Üyenin API anahtarlarını maskeli olarak listeler.
POST	`/api-keys`	API anahtarı oluşturma	Yeni workspace anahtarı üretir; tam değer sadece bir kez gösterilir.
POST	`/api-keys/revoke`	API anahtarı iptal	Aktif anahtarı iptal eder.
GET	`/ai-providers`	Kullanıcı AI sağlayıcıları	Üyenin OpenAI/Claude/Gemini/OpenRouter vb. provider ayarlarını listeler.
POST	`/ai-providers`	AI provider kaydetme	API key şifreli saklanır, arayüzde maskeli görünür.
POST	`/assistant/message`	Site içi AI asistan mesajı	Widget üzerinden site içi cevap üretir, gizli veri ve site dışı soruları reddeder.
GET	`/support`	Destek talepleri	Üye destek taleplerini listeler.
POST	`/support`	Destek talebi oluşturma	Teknik destek, faturalama, YouTube/kanal veya özellik talebi oluşturur.
GET	`/announcements`	Duyurular	Platform duyurularını gösterir.
GET	`/youtube/connect`	YouTube hesap slotları	Kanal slotlarını ve seçili upload hedefini listeler.
GET	`/analytics`	Kanal analiz	YouTube Data API varsa kanal performans özetini gösterir.
GET	`/automations`	Otomasyon merkezi	Üretim, kaynak, kalite, yayın ve performans akışlarını listeler.
GET	`/billing`	Paket & kredi	Plan, kredi ve ledger hareketlerini gösterir.

Örnek İstekler

AI Asistan mesajı

curl -X POST https://amele.us/assistant/message \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'message=Özellik Merkezi nasıl çalışır?'

Destek talebi

curl -X POST https://amele.us/support \
  -H 'Cookie: sid=...' \
  -d 'subject=YouTube bağlantısı' \
  -d 'category=YouTube / kanal' \
  -d 'priority=normal' \
  -d 'message=Kanalımı bağlamak istiyorum.'

Modül çalıştırma

curl -X POST https://amele.us/feature/{featureId} \
  -H 'Cookie: sid=...' \
  -d 'prompt=Kanal için SEO kontrol listesi oluştur' \
  -d 'priority=normal'

WordPress Connector asistan endpointi

curl -X POST https://amele.us/wp-demo/wp-json/synthory/v1/assistant \
  -H 'Content-Type: application/json' \
  -d '{"message":"WordPress blog SEO nasıl çalışır?"}'

Güvenlik ve Yetki Modeli

Üye işlemleri oturum gerektirir.
Admin işlemleri role=admin hesabı gerektirir.
Şifreler hashlenir; mevcut şifre asla gösterilmez.
Kullanıcı AI API keyleri şifreli saklanır ve arayüzde maskelenir.
AI Asistan site dışı ve gizli veri isteklerini reddeder.
Audit log; login, API key, assistant, feature usage ve admin işlemlerini takip eder.
notifySubscribers varsayılanı otomasyonlarda kapalı tutulur.
YouTube açıklamalarında kaynak URL paylaşılmaması ürün politikasıdır.

WordPress Connector API

WordPress demo entegrasyonu /wp-demo/ altında çalışır. Connector eklentisi; AI içerik üretimi, canlı destek widget, lead/operatör kaydı ve SEO blog akışlarını WordPress admin paneline taşır.

`/wp-demo/wp-json/synthory/v1/assistant`	WordPress site içi asistan endpointi
`/wp-demo/wp-admin/admin.php?page=synthory-connector`	Connector bağlantı ayarları
`/wp-demo/wp-admin/admin.php?page=synthory-content-studio`	AI İçerik Studio
`/wp-demo/wp-admin/admin.php?page=synthory-leads`	Lead & Operatör kayıtları

Versiyonlama ve Entegrasyon Notları

Bu dokümantasyon ana domain üzerindeki canlı Synthory platform route’larını ve WordPress demo entegrasyonunu kapsar. Harici geliştirici kullanımı için önerilen yaklaşım:

Önce üye panelinden Workspace API key oluşturun.
Test ortamında küçük hacimli isteklerle başlayın.
Feature/modül işlemlerinde kredi maliyetini kontrol edin.
Secret değerlerini istemci tarafında göstermeyin.
Webhook ve OAuth entegrasyonları için domain bazlı callback URL’leri kullanın.