Konfigurer den godkendelse, der er nødvendig for at teste Knowledge Base-API'en eller forbinde en app til den.
Knowledge Base-API-anmodninger bruger bearer-token-godkendelse. Brug et godkendt brugertoken til kortsigtet test, eller konfigurer en teknisk konto til en app eller integration.
Inden du går i gang
Sørg for at:
- Vores organisation har adgang til Knowledge Base.
- Du har adgang til de API-ressourcer, der kræves til dit arbejdsforløb.
- Du kan få adgang til Adobe Developer Console, når du konfigurerer en appintegration.
API-adgang tilsidesætter ikke Knowledge Base-tilladelser.Den godkendte identitet skal have adgang til de samlinger, dokumenter og handlinger, som appen anmoder om.
Vælg en godkendelsesmetode
Brug den godkendelsesmetode, der matcher din udviklingsfase.
| Brugseksempel | Godkendelse |
|---|---|
| Test anmodninger eller udforsk API'en | Bearer-token for godkendt bruger |
| Byg en app eller integration | Teknisk konto |
Bearer-token for bruger
Et bearer-token for en godkendt bruger er nyttigt til test af API-anmodninger, herunder anmodninger udført gennem API-referencen.
Tokenet repræsenterer den indloggede bruger og er gyldigt i 24 timer.Anmodninger udført med tokenet har samme Knowledge Base-adgang, som er tilgængelig for den pågældende bruger.
Efter at have fået en brugers bearer-token skal du inkludere det med hver anmodning:
Authorization: Bearer <access-token>
Du kan også bruge tokenet med den interaktive Knowledge Base-API-reference til at teste tilgængelige endpoints.
Start med en handling, der henter en ressource, du allerede har adgang til. Et vellykket svar bekræfter, at tokenet accepteres, og den godkendte identitet kan få adgang til den pågældende ressource.
Byg ikke en vedvarende appintegration omkring en brugers bearer-token.
Teknisk konto
Brug en teknisk konto til apps og integrationer, der skal autentificere uden en interaktiv brugersession.
Tekniske konti konfigureres gennem Adobe Developer Console. Følg opsætningsprocessen for teknisk konto for at oprette de legitimationsoplysninger, som din app kræver.
Når du har oprettet den tekniske konto, skal du vende tilbage til denne side for at validere din adgang til Knowledge Base API'en.
Forstå API-tilladelser
Autentificering fastslår identiteten, der fremsender API-anmodningen. Tilladelse bestemmer, hvad denne identitet kan gøre.
For eksempel kan en autentificeret identitet muligvis hente én samling, men ikke en anden, eller har måske ikke adgang til en ressource på administratorniveau.
Hvis autentificering lykkes, men en handling afvises, skal du kontrollere, at den autentificerede identitet har tilladelse til at få adgang til den anmodede ressource, inden du behandler svaret som en autentificeringsfejl.
Valider din API-adgang
Når autentificering er konfigureret:
- Få et adgangstoken.
- Send en anmodning til en ressource, som den autentificerede identitet kan få adgang til.
- Bekræft, at API'en returnerer det forventede svar.
- Fortsæt med API'ens kom godt i gang-arbejdsforløb.
