Ürün Fotoğraflı Kreatifler
Dragla’nın Ürün Fotoğraflı Reklam Kreatifleri API’si ile uygulamanızın ya da kullanıcılarınızın ürünlerini sergilemek için en uygun ve en çarpıcı ortamları oluşturarak profesyonel gönderiler oluşturabilirsiniz. Bu dökümantasyon, Ürün Fotoğraflı Reklam Kreatifleri 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 |
|---|---|---|---|---|
| ProductName | String | Zorunlu | Ürün ya da marka adı. | Örnek : Dragla |
| ProductDescription | String | Zorunlu | Ürün ya da marka açıklaması. | Örnek : Akıllı gönderi oluşturma platformu. |
| ProductImageUrl | String | Zorunlu | Ürün ya da marka tipi. | Örnek : Uygulama |
| BackgroundMode | String | Zorunlu | Arka plan seçimi. | Surprise me, Studio, Silk, Cafe, Tabletop, Light Wood, Dark Wood, Marble, Park Bench, Outdoors, Flowers, Roses, Lavender, Monstera, Meadow, Dried Flowers, Kitchen, Fruits, Nature, Beach, Bathroom, Skyscraper, Gifts, Christmas, Wedding, Halloween, Easter, Paint, Fire, Water, Gold, Pebbles, Snow |
| 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 |
| PostSize | String | Zorunlu | Gönderinizin boyutunu belirler. | square, vertical, story |
| Keywords | String | Opsiyonel | Anahtar kelimeleri belirtir. | Örnek : atatürk, türkiye |
| Audience | String | Opsiyonel | Gönderinizin hedef kitlesini tanımlar. | Örnek : herkes |
| 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...) |
İ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
Yaklaşık 30 ile 45 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]
Oluşturma işlemi devam ediyorsa "Processing" cevabını alacaksınız.
Görseller oluşturulduysa aşağıda ki gibi başarılı bir cevap alacaksınız.
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ı! |
