Nakonfigurujte ověřování požadované k testování rozhraní API Knowledge Base nebo připojení aplikace k němu.
Žádosti rozhraní API Knowledge Base používají ověřování pomocí bearer tokenu. Použijte ověřený uživatelský token pro krátkodobé testování nebo nakonfigurujte technický účet pro aplikaci nebo integraci.
Na úvod
Ujistěte se, že:
- Vaše organizace má přístup k Knowledge Base.
- Máte přístup k prostředkům rozhraní API požadovaným pro váš pracovní postup.
- Máte přístup ke službě Adobe Developer Console, pokud nastavujete integraci aplikace.
Přístup k rozhraní API nepřepisuje oprávnění Knowledge Base. Ověřená identita musí mít přístup ke kolekcím, dokumentům a operacím požadovaným aplikací.
Zvolte metodu ověřování
Použijte metodu ověřování, která odpovídá vaší fázi vývoje.
| Případ použití | Ověření |
|---|---|
| Testovat požadavky nebo prozkoumat rozhraní API | Bearer token ověřeného uživatele |
| Vytvořit aplikaci nebo integraci | Technický účet |
Bearer token uživatele
Bearer token ověřeného uživatele je užitečný pro testování žádostí rozhraní API, včetně žádostí prováděných prostřednictvím reference rozhraní API.
Token představuje přihlášeného uživatele a je platný 24 hodin. Žádosti provedené s tokenem mají stejný přístup k Knowledge Base, který je dostupný danému uživateli.
Po získání bearer tokenu uživatele jej zahrňte do každé žádosti:
Authorization: Bearer <access-token>
Token můžete také použít s interaktivní referencí rozhraní API Knowledge Base k testování dostupných koncových bodů.
Začněte operací, která načte prostředek, ke kterému již máte přístup. Úspěšná odpověď potvrzuje, že je token přijat a ověřená identita může k danému prostředku přistupovat.
Nevytvářejte trvalou integraci aplikace založenou na uživatelském bearer tokenu.
Technický účet
Používejte technický účet pro aplikace a integrace, které se potřebují ověřit bez interaktivní uživatelské relace.
Technické účty jsou konfigurovány prostřednictvím aplikace Adobe Developer Console.Postupujte podle procesu nastavení technického účtu a vytvořte přihlašovací údaje potřebné pro vaši aplikaci.
Po vytvoření technického účtu se vraťte na tuto stránku a ověřte svůj přístup k rozhraní API Knowledge Base.
Pochopení oprávnění API
Ověření identity určí identitu, která podává požadavek na API.Autorizace určuje, co daná identita může dělat.
Například ověřená identita může být schopna načíst jednu kolekci, ale ne jinou, nebo nemusí mít přístup k prostředku na úrovni správce.
Pokud ověření proběhne úspěšně, ale operace je zamítnuta, ověřte, že ověřená identita má oprávnění k přístupu k požadovanému prostředku, než budete považovat odpověď za selhání ověření.
Ověřte svůj přístup k API
Po konfiguraci ověření:
- Získat přístupový token.
- Odešlete požadavek na prostředek, ke kterému má ověřená identita přístup.
- Ověřte, že rozhraní API vrací očekávanou odpověď.
- Pokračujte v pracovním postupu Začínáme s API.
