Bilgi Bankası API'sini test etmek veya bir uygulamayı buna bağlamak için gerekli kimlik doğrulamasını yapılandırın.
Bilgi Bankası API istekleri bearer token kimlik doğrulaması kullanır. Kısa süreli test için kimliği doğrulanmış kullanıcı belirteci kullanın veya bir uygulama ya da entegrasyon için teknik hesap yapılandırın.
Başlamadan önce
Şunlardan emin olun:
- Kuruluşunuzun Bilgi Bankası erişimi var.
- İş akışınız için gerekli API kaynaklarına erişiminiz var.
- Uygulama entegrasyonu kuruyorsanız Adobe Developer Console'a erişebiliyorsunuz.
API erişimi Bilgi Bankası izinlerini geçersiz kılmaz. Kimliği doğrulanmış kimliğin, uygulama tarafından istenen koleksiyonlara, belgelere ve işlemlere erişimi olmalıdır.
Bir kimlik doğrulama yöntemi seçme
Geliştirme aşamanıza uygun kimlik doğrulama yöntemini kullanın.
| Kullanım örneği | Kimlik Doğrulama |
|---|---|
| İstekleri test edin veya API'yi keşfedin | Kimliği doğrulanmış kullanıcı bearer token'ı |
| Uygulama veya entegrasyon oluşturun | Teknik hesap |
Kullanıcı taşıyıcı belirteci
Kimliği doğrulanmış kullanıcı taşıyıcı belirteci, API referansı aracılığıyla yapılan istekler de dahil olmak üzere API isteklerini test etmek için kullanışlıdır.
Belirteç oturum açmış kullanıcıyı temsil eder ve 24 saat geçerlidir. Belirteçle yapılan istekler, o kullanıcının sahip olduğu Bilgi Bankası erişimiyle aynıdır.
Kullanıcı taşıyıcı belirtecini aldıktan sonra bunu her isteğe dahil edin:
Authorization: Bearer <access-token>
Belirteç, mevcut uç noktaları test etmek için etkileşimli Bilgi Bankası API referansıyla da kullanılabilir.
Zaten erişiminiz olan bir kaynağı alan bir işlemle başlayın. Başarılı bir yanıt, belirtecin kabul edildiğini ve doğrulanmış kimliğin o kaynağa erişebildiğini onaylar.
Kullanıcı taşıyıcı belirteci etrafında kalıcı uygulama entegrasyonu oluşturmayın.
Teknik hesap
Etkileşimli kullanıcı oturumu olmadan kimlik doğrulama yapması gereken uygulamalar ve entegrasyonlar için teknik hesap kullanın.
Teknik hesaplar Adobe Developer Console aracılığıyla yapılandırılır. Uygulama için gereken kimlik bilgilerini oluşturmak üzere teknik hesap kurulum sürecini izleyin.
Teknik hesabı oluşturduktan sonra Bilgi Bankası API'sine erişiminizi doğrulamak için bu sayfaya geri dönün.
API izinlerini anlama
Kimlik doğrulama, API isteğini yapan kimliği belirler. Yetkilendirme, bu kimliğin ne yapabileceğini belirler.
Örneğin, kimliği doğrulanmış bir kullanıcı bir koleksiyonu alabilir ancak başka bir koleksiyonu alamayabilir veya yönetici düzeyindeki bir kaynağa erişimi olmayabilir.
Kimlik doğrulama başarılı olur ancak bir işlem reddedilirse, yanıtı kimlik doğrulama hatası olarak değerlendirmeden önce doğrulanmış kimliğin istenen kaynağa erişim izni olduğunu doğrulayın.
API erişiminizi doğrulama
Kimlik doğrulama yapılandırıldıktan sonra:
- Bir erişim belirteci edinin.
- Kimliği doğrulanmış kullanıcının erişebileceği bir kaynağa istek gönderin.
- API'nin beklenen yanıtı verdiğini onaylayın.
- API'yi kullanmaya başlama iş akışıyla devam edin.
