API'ye genel bakış - Macaly Documentation

Macaly API’si, harici uygulamaların sohbet oturumları oluşturmasına, yapay zeka ile web uygulamaları geliştirmesine ve bunları programatik olarak üretime dağıtmasına olanak tanır.

Yalnızca Ajans planında kullanılabilir

Temel URL

https://www.macaly.com

Hızlı başlangıç

API anahtarı alın - Bkz. Kimlik doğrulama
Sohbet oluşturun - Geliştirmeye başlamak için bir istem gönderin
İlerlemeyi takip edin - Yapay zekanın işini bitirmesini bekleyin
Dağıtın - Uygulamanızı üretime yayınlayın

Mevcut endpoint’ler

Metot	Endpoint	Açıklama
POST	`/api/chat`	Yeni bir sohbet oluşturma ve geliştirmeye başlama
POST	`/api/chat/{chatId}/publish`	Mevcut bir sohbete mesaj gönderme
POST	`/api/client-app/assets/upload`	Dosya yükleme ve kalıcı bir CDN URL’si alma
GET	`/api/chat/{chatId}/status`	İşlem durumunu takip etme
GET	`/api/chat/{chatId}/subscribe`	Gerçek zamanlı stream’e abone olma
POST	`/api/chat/{chatId}/deploy`	Sohbeti üretime dağıtma
GET	`/api/chat/{chatId}/deployment`	Dağıtım durumunu alma

İstek limitleri ve krediler

API istekleri, ekibinizin bakiyesinden kredi harcar
Her sohbet oluşturma, web arayüzünü kullanmakla aynı maliyettedir
Başarısız API anahtarı denemeleri sınırlandırılır (IP başına dakikada 5)
Kullanımınızı Ayarlar → Kullanım ve Sınırlar bölümünden takip edin

Hata yönetimi

Tüm hatalar, error alanı içeren bir JSON döndürür:

{
  "error": "Error message here"
}

HTTP durum kodları

Kod	Açıklama
400	Bad Request - Geçersiz istek gövdesi
401	Unauthorized - Geçersiz veya eksik API anahtarı
402	Payment Required - Yetersiz kredi
403	Forbidden - Yetki yok veya yanlış ekip
404	Not Found - Kaynak bulunamadı
422	Unprocessable Entity - Doğrulama hatası
429	Too Many Requests - İstek limiti aşıldı
500	Internal Server Error - Sunucu taraflı hata
503	Service Unavailable - Sunucu meşgul, daha sonra tekrar deneyin