Pinterest API Kurulumu

Pinterest entegrasyonu için admin walkthrough. Son-kullanıcı akışı: Bağlantılar → Pinterest.

Genel bakış

Form alanı	Options anahtarı
App ID	pinterest_app-id
App Secret	pinterest_app-secret
Status	pinterest_integration_status

ENV fallback: PINTEREST_APP_ID + PINTEREST_APP_SECRET.

developers.pinterest.com adım adım

1. Giriş yap ve app oluştur

https://developers.pinterest.com → My Apps → Connect app. Yoksa Pinterest seni bir geliştirici profili oluşturmaya yönlendirir (tek seferlik form: şirket bilgisi, kullanım amacı).

Şunları ver:

• App adı
• Açıklama
• Website URL: https://sosyabot.com

2. Redirect URI yapılandır

Yeni app'in ayarlarında:

• Redirect URIs:

  https://app.sosyabot.com/api/v1/auth/pinterest/callback

  Self-hoster'lar: BASE_URL'inle değiştir.

3. Scope'ları talep et

Sosyabot'un kullandığı Pinterest API v5 scope'ları: boards:read, pins:read, pins:write, user_accounts:read. Pinterest'in Trial kademesinde anında kullanılabilir (sınırlı request rate); daha yüksek rate limit için Marketing API başvuru formu üzerinden Standard erişim talep et.

4. App ID + App Secret'ı al

App ayarları → App credentials. App ID ve App Secret'ı kopyala.

Sosyabot admin paneline yapıştırma

/admin/api-integration/pinterest. Yapıştır, Enable, Save, Test credentials.

Hata: Pinterest integration disabled: app id/secret not configured.

Doğrulama

/app/channels → Connect → Pinterest → OAuth → onayla → bağlantı sonrası ekranda varsayılan board seç. /app/publishing'den test bir görsel pinle.

Sorun giderme

Belirti	Sebep	Çözüm
Pinterest integration disabled: app id/secret not configured	Admin + ENV boş	1-4. adımlar.
v5 endpoint'te 403 invalid scope	Trial tier rate limit / scope yok	Pinterest Marketing API formu üzerinden Standard erişim talep et.
Token 30 gün sonra expire	Varsayılan Pinterest TTL	Sosyabot tokenRefresh.queue.ts üzerinden süre dolmadan 7 gün önce otomatik yeniler — worker'ın çalıştığını doğrula.
Pin board_id is invalid ile başarısız	Kullanıcının seçili varsayılan board'u yok	Kullanıcı kanal ayarlarında varsayılan board'u yeniden seçmeli.

ENV fallback

PINTEREST_APP_ID=<app id'in>
PINTEREST_APP_SECRET=<app secret'in>

.env düzenledikten sonra ./service.sh restart api.

İlgili

OAuth Kimlik Bilgileri genel

Pinterest kullanıcı bağlantı

OAuth Callback URL'leri