Gönderi Sihirbazı
Dragla’nın Gönderi Sihirbazı API’si ile uygulamanız ya da kullanıcılarınız için etkileyici ve etkileşimi yüksek görsel veya video kolaj gönderileri oluşturabilirsiniz. Bu dökümantasyon, Gönderi Sihirbazı ile gönderi oluşturma işlemlerini adım adım nasıl gerçekleştirebileceğinizi anlatmaktadır.
Başlangıç
API'yi kullanmak için bir API anahtarına ihtiyacınız olacak. Bu API anahtarını almak için (https://app.dragla.co/api) sayfasını ziyaret edin ve kayıt olduktan sonra anahtarınızı edinin. API anahtarınızı aldıktan sonra, bu anahtarı kullanarak API isteklerinizi doğrulayabilirsiniz.
Authorization: X-Api-Key: YOUR_API_KEY
Parametreler
| Property | Data Type | Required | Description | Parameters |
|---|---|---|---|---|
| Title | String | Zorunlu | Gönderinizin başlığını belirtir. | Örnek : Sosyal Medya Stratejisi Nasıl Olmalıdır? |
| LogoUrl | String | Zorunlu | Gönderinizdeki logo alanı için kullanılacaktır. | Örnek : https://www.storagesite.com/logo.png |
| Website | String | Zorunlu | Gönderinizdeki website alanı için kullanılacaktır. | Örnek : www.siteniz.com ya da @kullaniciadi |
| Language | String | Zorunlu | Gönderinizin dilini belirtir. | English, Turkish, Espanol, French, German, Italian, Japanese, Korean |
| PostType | String | Zorunlu | Gönderinizin türünü belirler. | image, video-collage, video |
| PostSize | String | Zorunlu | Gönderinizin boyutunu belirler. | square, vertical, story |
| Keywords | String | Opsiyonel | Anahtar kelimeleri belirtir. | Örnek : sosyal medya, dijital pazarlama, reklam |
| Audience | String | Opsiyonel | Gönderinizin hedef kitlesini tanımlar. | Örnek : Girişimciler |
| Tone | String | Opsiyonel | Gönderinizin tonunu belirler. | excited, professional, encouraging, dramatic, engaging, creative |
| ColorPalette | Object | Opsiyonel | Gönderilerin renk ayarlarını değiştirir. Gönderilerinizdeki renklerin seçimini Dragla'nın yapay zekasına bırakmak isterseniz bu alanı boş bırakın! |
ColorOne, ColorTwo, ColorThree, ColorFour alanlarının tümü zorunludur. Hex Kodu Olmalıdır! (#ad8b73 gibi...) |
| Images | Array | Opsiyonel | Gönderilerinizdeki resimleri özel olarak eklemek için gerekli alan. Gönderilerinizdeki resimlerin seçimini Dragla'nın yapay zekasına bırakmak isterseniz bu alanı boş bırakın! |
"Index" ve "Url" değerlerini alır. "Index" değeri hangi gönderi için olduğunu belirtir. Örneğin : "Index : 1" ilk gönderideki resimleri değiştireceğiniz anlamına gelir. |
| VoiceOver | String | Opsiyonel | Videolarınız için seslendirme ayarı. | on, off (Varsayılan olarak "on" değerini alır.) |
İstek [POST]
Not : Aşağıdaki örnek tam bir istek yapısına sahiptir zorunlu alanlar dışındakileri göndermek zorunda değilsiniz.
Başarılı Cevap
Görseller için yaklaşık 30 ile 45 saniye arasında, video ve video kolaj gönderiler için 50 ile 80 saniye arasında bir dönüş süresi olacaktır. Lütfen dönüş sürelerini göz önüne bulundurun.
Sonuçları alabilmeniz için "creationId" ile aşağıdaki şekilde "GET" işlemini yapmanız gerekmektedir.
Sonuçlar [GET]
Görseller ya da videonuz sıraya alındıysa "Queued" oluşturma işlemi devam ediyorsa "Processing" cevabını alacaksınız.
Görseller ya da video oluşturulduysa aşağıda ki gibi başarılı bir cevap alacaksınız.
Gönderi türü olarak "video" ya da "video-collage" seçtiyseniz dönen cevabın içerisindeki "index : 1" değerindeki "url" alanında video linkiniz olacaktır.
Hata Kodları
| Code | Name | Description |
|---|---|---|
| 400 | Bad Request | Geçersiz İstek Biçimi. İstek parametrelerinizi kontrol ediniz. |
| 401 | Unauthorized | Yetkisiz kullanıcı. Gönderilen API Anahtarınızı kontrol edin. |
| 404 | Not Found | Belirtilen adres için geçerli bir sonuç bulunamadı. |
| 406 | Not Acceptable | API Anahtarınızı kontrol ediniz. |
| 500 | Server Error | Sunucudaki sorun nedeniyle istek tamamlanamadı! |
