API lösningar hos iBinder
Integrera enkelt med externa system
Checklista inför en integration:
- Vilka integrationsmöjligheter har det andra systemet? (API, import/export, webhooks etc.)
- Finns teknisk kompetens tillgänglig? (Internt utvecklingsteam eller extern konsult med API-erfarenhet)
- Vilken typ av information ska utbytas? (T.ex. dokument, metadata, projekt, användare)
Hur ofta ska informationen synkas? (Kontinuerligt, dagligen, manuellt)
Behövs tvåvägsintegration? (Ska båda systemen kunna både läsa och skriva?)
Vilka delar av organisationen ska integrationen ha åtkomst till? (Hela organisationen eller utvalda områden)
Observera: Vi rekommenderar endast att använda våra API:er om ni har teknisk kompetens och erfarenhet inom API-integration. iBinder erbjuder inte support för kod eller felsökning av klientimplementeringar.
Dokumentation
Dokumentationen för vårt publika API finns på api-docs.ibinder.com. Där hittar du kom igång-guider, information om autentisering, en snabbstart och en komplett referens över alla endpoints.
Autentisering och API-klienter
Vi använder OAuth 2.0 med flödet client credentials. Varje API-klient tillhör en organisation och autentiseras med ett klient-ID och en klienthemlighet (client secret). API-klienter är ett tillägg. Kontakta vår support för att aktivera dem för din organisation. När de är aktiverade sköter organisationens ägare allt själva i iBinder, under API-klienter i organisationsmenyn. Där kan de skapa klienter, välja roll för varje klient (Läsare, Skapare eller Administratör), återställa hemligheter och ta bort klienter som inte längre används.
Åtkomst begränsad per område (Enterprise)
En API-klient behöver inte ha åtkomst till hela organisationen. Med Enterprise kan du begränsa en klient till ett eller flera områden och välja dess roll i vart och ett. Du kan lägga till eller ta bort områden i efterhand utan att skapa en ny klient. På så sätt kan du testa en integration i ett enskilt projekt eller en region, hålla påverkan låg och ge mer åtkomst när du är redo.
Presigned URL-uppladdning
iBinder använder presigned URL:er för filuppladdning. Det innebär att klienten får en tillfällig länk med åtkomsträttigheter och kan ladda upp filer direkt till lagringen utan att gå via API:et. Detta ger en effektiv och säker uppladdning, styrd av Azure Blob Storage-begränsningar.
Format på förfrågningar och svar
Endast JSON stöds för request- och response-data.
API-versionering och bakåtkompatibilitet
iBinders API är för närvarande i version 1.0. För att säkerställa bakåtkompatibilitet och möjliggöra ändringar utan att bryta befintliga integrationer används versionshantering. Version 1.0 har ingen versionsindikator i URL:en (bas-URL: https://api.ibinder.com/api). Framtida versioner kommer att ha versionsnummer i URL:en, t.ex. https://api.ibinder.com/api/v2.
iBinder strävar efter att undvika brytande ändringar och föredrar istället stegvisa tillägg. Vid behov av förändringar ges förhandsinformation och kunder ges tid att uppdatera sina integrationer. Varje version stöds minst 12 månader efter att en ny version släppts.
Begränsning av API-anrop (Rate limiting)
För att motverka missbruk och säkerställa rättvis användning tillämpas rate limiting och throttling. Begränsningar varierar beroende på klienttyp och förfrågning. Vid överskridna gränser returneras svaret ”429 Too Many Requests”.
Dokumentation och test
Allt du behöver för att komma igång finns i vår publika dokumentation på api-docs.ibinder.com, bland annat en färdig Postman-samling för tester. Hör gärna av dig om du har några frågor.