Bu rehberde: Canva hesabınızı bağlarsınız. İş akışı tasarımlarınızı arar, seçtiğiniz tasarımı PNG, JPG veya PDF olarak dışa aktarır ve çıkan görsel bağlantısını doğrudan bir gönderide kullanır.
⏱ 5 dakika (platformun Canva entegrasyonu onaylıysa)
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | CANVA |
| Kategori | Veri ve tasarım |
| Kimlik doğrulama | İzin ekranı (Canva Connect, OAuth 2 + PKCE) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Kutu | Canva (app.canva) |
Ne işe yarar?
| İşlem | Ne yapar | Etki |
|---|---|---|
| List designs | Tasarımları başlığa göre arar (boşsa en son düzenlenenler). Her tasarım ayrı öğe olur: designId, title, pageCount, thumbnailUrl, editUrl, viewUrl. | Okuma |
| Export design | Tasarımı PNG, JPG (kalite 1–100) veya PDF olarak dışa aktarır, iş bitene kadar bekler (en fazla ~2 dakika). İsteğe bağlı sayfa seçimi (1,2) ve genişlik (px). Çıktı: url (ilk sayfa), urls (sayfa başına), pageCount, expiresAt. | Okuma |
designId, tasarım adresinden de verilebilir: https://www.canva.com/design/DAF…/…/edit.
İndirme bağlantıları 24 saat geçerlidir. Görseli kalıcı saklamak istiyorsanız aynı akışta Dropbox ile kaydedin.
Dışa aktarılan görseli gönderide kullanma
Gönderi yayınla (veya Gönderi planla) kutusunun Media URLs alanına dışa aktarma çıktısını verin:
Canva · Export design (designId: DAF…, format: jpg)
→ Gönderi yayınla platform: INSTAGRAM
text: {{ $json.caption }}
mediaUrls: {{ [$json.url] }}
- Instagram yalnızca JPEG kabul eder: Format =
JPGseçin. Çok sayfalı tasarımda tüm sayfalar için{{ $json.urls }}verin (karusel destekleyen platformlarda). - Planlı gönderilerde bağlantının süresi dolmadan (24 saat) yayın zamanı gelmelidir; daha uzun planlar için önce Dropbox'a kaydedip paylaşım linkinin
downloadUrldeğerini kullanın.
Ön koşullar
- Bir Canva hesabı. Premium öğe içeren tasarımlar yalnızca o öğeye lisansı olan hesapla dışa aktarılabilir (
license_required). - Platform tarafında onaylı Canva Connect entegrasyonu (
CANVA_CLIENT_ID,CANVA_CLIENT_SECRET).
Adım adım kurulum
- Entegrasyonlar → Canva → Bağla → Proje seçin.
- Canva ile devam et → hesabınızı (ve gerekiyorsa ekibinizi) seçin → Allow.
- Kartta Canva görünen adınız çıkar. Bağlantıyı test et ile kontrol edin.
Platform yöneticisi: uygulama kaydı
- Canva Developer Portal → Your integrations → Create an integration → tür Public (tüm Canva kullanıcıları için; yalnızca kendi ekibiniz için Private de olur).
- Configuration: ad, açıklama, logo; Client secret oluşturun.
- Scopes:
design:meta:read,design:content:read,asset:read,profile:read(okuma yeterli; yazma kapsamı istemeyin). - Authentication → Authorized redirects:
https://api.orqlabs.com/api/v1/integrations/oauth/canva/callback. - Client ID →
CANVA_CLIENT_ID, Client secret →CANVA_CLIENT_SECRET, API'yi yeniden başlatın. - Submit for review: Public entegrasyonlar Canva incelemesinden geçene kadar yalnızca geliştirici hesabı ve ekibi tarafından kullanılabilir. İncelemede kullanım senaryosunu (tasarım dışa aktarıp sosyal medyada yayınlama) ve gizlilik politikası bağlantısını hazır tutun.
Bağlantı PKCE (S256) ile yapılır; erişim anahtarı 4 saat geçerlidir ve otomatik yenilenir. Canva yenileme anahtarları tek kullanımlıktır – OrqLabs her yenilemede yenisini saklar.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
FORBIDDEN – license_required | Tasarımda lisanssız premium öğe var | Öğeyi lisanslayın veya değiştirin |
FORBIDDEN – approval_required | Marka onay süreci tamamlanmadı | Canva'da tasarımı onaylatın |
RATE_LIMIT – 429 | Kullanıcı başına dakikada 20 dışa aktarma isteği / 5 dakikada 75 dışa aktarma aşıldı | Akış sıklığını azaltın; otomatik yeniden denenir |
NOT_FOUND | Tasarım silinmiş veya bu hesapla paylaşılmamış | List designs ile kimliği doğrulayın |
| İzin ekranında "integration not available" | Entegrasyon henüz Canva onayından geçmedi | Platform yöneticisi incelemeyi tamamlamalı |