Transpa API

Du som Transpa-kund är ägare av datan i er egen databas. Det är du som lämnar medgivande till en applikation att använda din data, att läsa eller skriva, och det är du som bestämmer vad som en applikation får se eller påverka. Detta görs med så kallade scopes. Scopes kan vara ett ämne eller område, som t ex anställda (employees) eller fordon (vehicles) och om de är read, write eller delete.   En applikation behöver ange vilka scopes den behöver för att fungera som den ska, så vill du nyttja en speciell app får du godkänna alla scopes som används. Men det är också möjligt för dig att dra tillbaka ditt godkännande, om du inte längre önskar att appen ska ha dessa rättigheter eller tillgångar till din data längre.   Ibland ändrar en applikation vilka scopes de behöver. De har kanske utökat sin funktionalitet och behöver därför ha tillgång till fler resurser i API:et och mer data i er databas för att fungera.   Att ta bort eller lägga till scopes görs i Visma App Store. Logga in med dina vanliga inloggningsuppgifter till Transpa, se till att du är i rätt företag (tenant) och klicka på My Apps. Klicka på appen du vill ändra scopes för och du får upp en lista med scopes som används och om du har godkänt dem eller inte (se bild nedan).  Aktivera eller inaktivera de scopes du önskar och klicka Update permissions så kan möjliggöra respektive förhindra tillgång till din data i ert Transpa.   Om du ska avsluta en app helt använder du istället Remove application till vänster.

Att aktivera en integration innebär att man rent tekniskt knyter ihop en applikation med ert Transpa, och att man godkänner åtkomsten att läsa och/eller skriva data dit. Detta gör via Visma App Store.   En applikation ska ange vilka behörigheter och moduler den behöver ha tillgång till för att fungera, t ex för anställda eller fordon, läsa eller skriva, så kontrollera gärna att dessa verkar rimliga innan du aktiverar en integration.   En applikation kan vara antingen publik eller inte, vilket avgör på vilket sätt som du skaffar den (aktiverar den).    Ladda ner bifogad PDF för hur du aktiverar en integration.

Visma Developer Portal En applikation som nyttjar Transpas API måste registreras på Visma Developer Portal. Det behövs för att kunna autentisera sig och kunna möjliggöra exponering på Visma App Store. Visma Developer Portal   Open API Specification Vår API-speficikation finns tillgänglig med all information om de resurser som kan användas, hur de används och status på utvecklingen av dem. Med hjälp av scheman och exempel kan du lätt förstå hur ett anrop ska göras och vad det får för respons. Transpa OAS (Swagger UI)   Transpa API på Github På vår egen Github-sida kan du ladda ner färdiga paket, så kallad Postman collection, för att underlätta uppsättning av autentisering. Här finns också möjlighet att skriva feature requests och rapportera buggar. Transpa-Public-API-Client   Visma App Store Att koppla ihop sitt Transpa med en applikation kräver aktivering via Visma App Store. Den som har behörighet Systeminställningar i Transpa har automatiskt inloggning hit, med samma uppgifter som till Transpa. Aktivering kan göras både för publika applikation och applikationer man fått en "invitation code" till, från en utvecklare.  Visma App Store   Prislista Att börja använda vårt API är kostnadsfritt, och kommer i många fall fortsätta vara kostnadsfritt, om man håller sig inom "free tier" - dvs max 1000 anrop i månaden och max 200 anrop i minuten. Om man har behov över det, får man höra av sig till oss, och "köpa" en så kallad subscription key, baserat på vilken kvota man är intresserad av. Prislista

Så roligt att du har hittat hit! Här kommer du att finna all information som har med vårt API att göra, vare sig det gäller att utveckla själv eller nyttja det någon annan har utvecklat. Du har kanske redan märkt att det finns en knapp på Transpas startsida, som heter API, där länkar till alla nödvändiga sidor finns. Denna Community handlar om att ge nyttig information, hjälpfulla tips och nyheter vad gäller våra resursen i det publika API:et.