Simplicedi API – Authentication

Simplicedi API är ett json-baserat REST API som erbjuder möjligheten för externa system att integrera med funktioner i Simplicedi. All kommunikation med Simplicedi API behöver verifieras för åtkomst genom ett så kallat token based client credentials flow.

Hämta din access token

1. Skaffa en klientnyckel (Client Key)

För att få åtkomst till Simplicedi API måste du först skaffa en så kallad klientnyckel. Klientnyckeln får du genom att kontakta EDI Solutions support. Klientnyckeln används för att avgöra vilka rättigheter du har i systemet, samt vilken kund du har åtkomst till.

Exempel på klientnyckel:

4727fa0c-a028-43a9-9c02-3e4059906ebf

2. Hämta din access token

Gör en POST request med din klientnyckel (tillagd i din request header med nyckel: clientkey) mot Authorization Token End Point https://test-authapi.simplicedi.com/v1.0/token för att hämta din access token. Varje access token har en begränsad livstid.

För vår produktionsmiljö ta bort test- från url:en ovan.

Exempel på access token:

Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Ik1Ea3pRevV7T0RRd01VTXlNRVUzTWtORE5ETTVNVFV3TnpZME9ESkZOakZEUlRCQ05rSkRRdyJ9.eyJpc3MiOiJodHRwczovL2Rldi1zaW1wbGljZWRpLmV1LmF1dGgwLmNvbS8iLCJzdWIiOiJ2OVRjZGYza3V3dHNLMk9wdFdTUk55YWkxaGdYRUhsZEBjbGllbnRzIiwiYXVkIjoiSk5sZklBB1BmeGQ4ZUdqVjN3MXo4NExNTGUya1huYXQiLCJpYXQiOjE1MjYzOTQwODMsImV4cCI6MTUyNjQ4MDQ4MywiYXpwIjoidjlUY2RmM2t1d3RzSzJPcHRXU1JOeWFpMWhnWEVIbGQiLCJndHkiOiJjbGllbnQtY3JlZGVudGlhbHMifQ.xUsBHFaNW8GgbKS8mLtk7EUCAEYrvhVZKIKGF4b8pgIELajEHRoH06n-pe9TZOnLkqMSAzrFYXcsqWH29YfnV1bARrg9UqNUtjg3i85nBuNXNj3KAF49qTqdp67V-QtwUQmmi-PN5xspZYp4JY8jUrBq03B5OM0oeThqxeVisHkoB7ZHnCkDEUpeGD2dOCvtUXMV2JZL3e7xP0M6FRkIs13L8L_U4ofFifZofALkX6-sLWFggxH6_cDgnXIrpDtt366NWEySKvUpzLXChAzpcNBEwCeRMrGxN8bcajwcG2SYMFFXM_04gh9Qx3U_VJDhAwmexm1KZP1QBc54pPH2zA

3. Använd din access token

Du använder nu din access token vid varje förfrågan mot Simplicedi API, genom att lägga till den i din request header med nyckel: authorization. Glöm inte att lägga till Bearer före din access token likt ovan.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s