Pinterest
Refresh-token grant ile OAuth 2.0. Token takası Basic auth (appId:appSecret) kullanır.
Kimlik bir bakışta
| Alan | Değer |
|---|---|
| Kimlik modeli | OAuth 2.0 |
| Gerekli ENV | PINTEREST_APP_ID, PINTEREST_APP_SECRET |
| Callback URL | ${BASE_URL}/api/v1/auth/pinterest/callback |
| Scope'lar / izinler | boards:read, pins:read, pins:write, user_accounts:read |
| Otomatik token yenileme | Evet — süresi dolmadan 7 gün önce |
Nasıl bağlanılır
- Bağlantılar → Pinterest → Bağlan'ı aç.
- Pinterest'e giriş yap ve scope'ları onayla.
- Bağlantı sonrası ekranda varsayılan board'u seç.
Token yenileme
Otomatik yenilenir. tokenRefresh.queue.ts worker'ı Pinterest hesaplarını tarar ve expiresAt - now < 7 gün olduğunda yeniler. Varsayılan access-token TTL'i 30 gündür.
Notlar
- Sosyabot, kullanıcının tam board listesini kanalın
dataalanında önbelleğe alır veboards[0]'ı varsayılan board olarak otomatik seçer. Varsayılanı kanal ayarlarından değiştir. - Pinterest uygulamasının Marketing API kademesi mevcut endpoint'leri etkiler —
403 invalid scopeile karşılaşırsan production erişimi için başvur. - Her pin belirli bir board'u hedeflemelidir; editörde Varsayılan board seçmek kanalın saklanan varsayılanını kullanır.
Sorun giderme
Kanal needs_reconnect gösteriyorsa, access token Pinterest tarafından reddedilmiştir. Yaygın sebepler:
- Kullanıcı Sosyabot'un yetkilendirmesini platform üzerinden iptal etmiştir.
- Platform token'ı geçersiz kılmıştır (şifre değişikliği, güvenlik olayı).
- OAuth uygulama kimlik bilgileriniz değişmiştir ve mevcut token'lar artık eşleşmiyordur.
Yukarıdaki bağlantı akışını yeniden çalıştır. Çalışma alanı genelinde checklist için Sorun Giderme'ye bak.