Geliştirici Genel Bakış
Sosyabot <BASE_URL>/api/v1/*'de bir REST API sergiler. Çoğu endpoint pano oturum açma akışı tarafından verilen bir oturum cookie'si gerektirir; küçük bir alt küme Authorization header'ı üzerinden bir kişisel API token'ı kabul eder.
Kimlik doğrulama
| Endpoint ailesi | Auth |
|---|---|
/api/v1/* (varsayılan) | Oturum cookie'si (token, httpOnly, oturum açma / OTP doğrulamada ayarlanır). |
/api/v1/public/* | API token, Authorization: Bearer <token> header üzerinden, açık scope'larla. |
/api/v1/auth/* | Yok (oturum açma / kayıt / OAuth callback'leri). |
/api/v1/webhooks/* | Inbound için yok (sağlayıcı tarafından imzalanır); outbound, kayıtlı webhook secret'ına bağlıdır. |
Hatalar
Hatalar tutarlı bir zarf kullanır:
json
{
"error": {
"code": "POST_NOT_FOUND",
"message": "Post does not exist"
}
}Yaygın kodlar: VALIDATION_ERROR (400), UNAUTHORIZED (401), FORBIDDEN (403), NOT_FOUND (404), CONFLICT (409), RATE_LIMITED (429), INTERNAL_ERROR (500).
Sayfalama
List endpoint'leri page (1-indexed) ve pageSize (varsayılan 25, maks 100) kabul eder. Yanıtlar { data, page, pageSize, total } içerir.