OAuth 2.0, "şifreni bana verme, bana izin ver" yaklaşımıdır. Kullanıcı platformda oturum açar ve uygulamaya belirli işler için izin verir. Uygulama şifreyi hiç görmez; yalnız sınırlı süreli bir access token alır. Standart RFC 6749 ile tanımlanır.
Temel kavramlar
| Kavram | Anlamı |
|---|---|
| Client | İzin isteyen uygulama, ör. entegrasyon yazılımı |
| Scope | İstenen izinlerin kapsamı, ör. yalnız ürün okuma |
| Authorization code | Kullanıcı onay verince dönen tek kullanımlık kod |
| Access token | API isteklerinde kullanılan kısa ömürlü belirteç |
| Refresh token | Süresi dolan belirteci yenilemek için kullanılan değer |
İki yaygın akış
Authorization code akışı: Kullanıcı platformun izin ekranına yönlendirilir, onay verir, uygulama dönen kodu belirtece çevirir. Etsy bu akışı kullanır. Saystok'un Etsy bağlantısı bu akışta PKCE (S256) uygular ve listings_r, listings_w, transactions_r, shops_r izinlerini ister. Belirtecin süresi dolunca refresh token ile yenilenir. PKCE, RFC 7636 ile tanımlanan ve kodun ele geçirilmesine karşı koruma sağlayan bir ektir.
Client credentials akışı: Ortada izin veren bir kullanıcı ekranı yoktur. Uygulama kendi kimliğiyle doğrudan belirteç alır. Pazarama'da belirteç, API bilgileriyle isortagimgiris.pazarama.com adresindeki connect/token ucundan client_credentials türüyle alınır. ikas da mağazaya özel bir oauth/token adresinden aynı türde belirteç verir.
Satıcı için ne değişir?
- Etsy gibi platformlarda bağlantıyı kurarken platformun kendi sayfasında "izin ver" düğmesine basarsınız. Şifrenizi entegrasyon yazılımına girmezsiniz.
- Verdiğiniz izni platformun hesap ayarlarından geri alabilirsiniz.
- İzinler kapsamlıdır; yazılım yalnız istediği ve sizin onayladığınız işleri yapabilir.
Sık sorunlar
- Belirteç süresi doldu: Yazılım refresh token ile yenileyemezse bağlantı düşer ve yeniden yetki vermeniz gerekir.
- Yönlendirme adresi uyuşmuyor: Uygulamaya tanımlı adres ile istekteki adres birebir aynı olmalıdır.
- Eksik scope: Ürün yazma izni verilmemişse stok güncelleme reddedilir.
Etsy tarafının ayrıntısı için Etsy Open API v3 ve OAuth yazısına bakın.