Geliştiriciler

API Dokümanı

Shortsly'yi kendi ürününe entegre et. REST API ile iş oluştur, durumu izle ve üretilen klipleri al.

API erişimi Business planında sunulur.

Kimlik doğrulama

Tüm istekler, panelden aldığın API anahtarını Authorization başlığında taşımalıdır. Anahtarını gizli tut.

Authorization: Bearer sk_live_xxxxxxxxxxxx

POST

İş oluştur

Bir video bağlantısı gönderir ve klip üretim işini başlatır. Oran ve dil isteğe bağlıdır.

curl -X POST https://api.shortslyai.com/v1/jobs \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://youtu.be/xyz",
    "ratio": "9:16",
    "language": "tr"
  }'

GET

İşi sorgula

Bir işin durumunu ve ilerlemesini döndürür. status alanı queued, processing veya ready olabilir.

GET /v1/jobs/job_123

{
  "id": "job_123",
  "status": "processing",
  "progress": 64
}

GET

Klipleri al

İş tamamlandığında üretilen klipleri, skorları ve indirme bağlantılarıyla döndürür.

GET /v1/jobs/job_123/clips

{
  "clips": [
    {
      "id": "clip_1",
      "score": 92,
      "duration": 38,
      "url": "https://cdn.shortslyai.com/..."
    }
  ]
}

POST

Webhook'lar

İş tamamlandığında belirttiğin adrese bir bildirim göndeririz; böylece sürekli sorgulamaya gerek kalmaz.

POST https://senin-sunucun.com/hook

{
  "event": "job.completed",
  "job_id": "job_123",
  "clips": 10
}