API Genel Bakış

FCA Farm REST API'si — programatik render submit ve sorgu.

FCA Farm tüm web/plugin işlevselliği bir REST API üzerinden çalışır. Bu API'ye API key veya JWT token ile erişebilirsin.

Base URL

https://fcafarm.com/asset-api/

Authentication türleri

1. JWT Bearer (plugin için)

Authorization: Bearer eyJ0eXAiOiJKV1Qi...

30 gün geçerli, plugin için Plugin sayfasından alınır.

2. API Key (programatik kullanım için)

Authorization: Bearer ff_xxxxxxxx_yyyyyyyy...

Süresiz, API Anahtarları sayfasından üretilir. Scope: jobs.submit, jobs.read

3. X-Bridge-Token (bridge için)

X-Bridge-Token: <BRIDGE_SECRET>

Sadece bridge/farm controller/slave agent kullanır.

Yanıt formatı

Tüm yanıtlar JSON. Başarı:

HTTP 200
Content-Type: application/json

{
  "data": { ... },
  "ok": true
}

Hata:

HTTP 4xx/5xx
{
  "error": "error_code",
  "message": "İnsan okunabilir mesaj"
}

Yaygın endpoint'ler

Endpoint	Auth	Açıklama
POST /render/jobs	JWT	Yeni render iş + manifest
GET /render/jobs	JWT	İş listesi
GET /render/jobs/{id}	JWT	İş detayı
PUT /render/upload/{sha256}	JWT	Asset binary upload
POST /render/jobs/{id}/start	JWT	İşi başlat (ready)
POST /render/jobs/{id}/cancel	JWT	İptal
GET /render/balance	JWT	Kullanıcı kredi bakiyesi
POST /render/estimate	JWT	Ön kredi tahmini

Detaylar: Jobs API · Auth & Tokens