Sådan får du adgang til og fejlsøger Addo Sign API'et
Addo Sign API'et giver dig mulighed for at arbejde programmatisk med Addo Sign-platformen, så du kan administrere dokumenter, underskrifter og lister.
Overblik over funktioner i Addo Sign API'et
Addo Sign Web Service API tilbyder funktioner, der svarer til dem, du finder i platformens brugerflade.
Med API'et kan du hente og administrere data, herunder lister, ved at kalde de relevante endpoints.
Der findes detaljeret dokumentation, som guider dig gennem de tilgængelige API-kald og deres parametre. Du skal være autentificeret for at få adgang til API-endpoints.
Adgangs- og abonnementskrav
API-adgang på testkonti
API-adgang er ikke tilgængelig på testkonti, og muligheden for at generere et access token vises derfor ikke. For at bruge API'et skal du som minimum have et Addo Starter-abonnement på en produktionskonto.
Ekstra gebyr for API-adgang
API-adgang er ikke inkluderet som standard i betalte abonnementer og kræver et ekstra månedligt gebyr. Husk derfor at tage denne omkostning med i vurderingen, når du vælger abonnement, hvis du har brug for API-funktionalitet.
Kontakt vores supportteam, hvis du har brug for mere information. De hjælper dig gerne videre.
Almindelige fejlsøgningsscenarier
Løsning af 401-fejlen "Authorization Header Invalid"
En 401-fejl med beskeden "Authorization header invalid" opstår, når der er en Authorization header i requesten, men den ikke er gyldig for det endpoint, der kaldes.
Addo Sign API'et prioriterer Authorization headeren over et token, der er angivet i request body. Følg disse trin for at løse problemet:
Hvis du bruger et login-token i request body, skal du fjerne Authorization headeren helt. Derefter bruges tokenet fra request body.
Hvis du bruger en Authorization header, skal du sikre, at den indeholder et gyldigt user token, der er genereret i Webadmin, og at requestets syntaks matcher den webservice, der kaldes.
Undgå at genbruge tokenværdier. Brug ikke den samme tokenværdi i både request body og Authorization header, da der er tale om forskellige tokentyper.
Når du har foretaget disse justeringer, bør dine requests kunne gennemføres.
Demooplysninger til MitID i API-requests
Demooplysninger til MitID skal ikke angives i det første API-request, for eksempel InitiateSigning. Disse værdier bruges først senere i processen, når MitID-identifikationen gennemføres.
Bedste praksis for brug af API'et
Gennemgå Addo Sign Web Service API-dokumentationen grundigt, så du forstår de tilgængelige endpoints og deres parametre.
Brug en produktionskonto med det relevante abonnement for at få adgang til alle API-funktioner.
Sørg for korrekt autentificering ved at bruge gyldige tokens og følge API'ets krav til syntaks.
Test dine API-kald i et demomiljø, før du bruger dem i produktion. Det minimerer risikoen for fejl.