API-løsninger til iBinder
Integrer nemt med eksterne systemer
Tjekliste før integration:
- Hvilke integrationsmuligheder har det andet system? (API, import/eksport, webhooks osv.)
- Er teknisk kompetence tilgængelig? (Internt udviklingsteam eller ekstern konsulent med API-erfaring)
- Hvilken type information skal udveksles? (f.eks. dokumenter, metadata, projekter, brugere)
Hvor ofte skal informationen synkroniseres? (Kontinuerligt, dagligt, manuelt)
Er der behov for tovejskommunikation? (Skal begge systemer kunne læse og skrive?)
Hvilke dele af organisationen skal integrationen have adgang til? (Hele organisationen eller udvalgte områder)
Bemærk: Vi anbefaler kun at bruge vores API’er, hvis I har teknisk kompetence og erfaring med API-integration. iBinder tilbyder ikke support til kode eller fejlfinding af klientimplementeringer.
Dokumentation
Dokumentationen til vores offentlige API findes på api-docs.ibinder.com. Her finder du kom godt i gang-guides, information om autentificering, en quickstart og en komplet reference over alle endpoints.
Autentificering og API-klienter
Vi bruger OAuth 2.0 med client credentials-flowet. Hver API-klient tilhører en organisation og autentificeres med et klient-ID og en klienthemmelighed (client secret). API-klienter er et tilvalg. Kontakt vores support for at få dem aktiveret for din organisation. Når de er aktiveret, klarer organisationens ejere det hele selv i iBinder under API-klienter i organisationsmenuen. Her kan de oprette klienter, vælge rolle for hver klient (Læser, Opretter eller Administrator), nulstille hemmeligheder og slette klienter, der ikke længere bruges.
Adgang begrænset pr. område (Enterprise)
En API-klient behøver ikke have adgang til hele organisationen. Med Enterprise kan du begrænse en klient til et eller flere områder og vælge dens rolle i hvert enkelt. Du kan tilføje eller fjerne områder efterfølgende uden at oprette en ny klient. På den måde kan du teste en integration i et enkelt projekt eller en region, holde påvirkningen lav og give mere adgang, når du er klar.
Presigned URL-upload
iBinder bruger presigned URL’er til filupload. Det betyder, at klienten får et midlertidigt link med adgangsrettigheder og kan uploade filer direkte til lageret uden at gå via API’et. Dette giver en effektiv og sikker upload, styret af Azure Blob Storage-begrænsninger.
Format på forespørgsler og svar
Kun JSON understøttes til request- og response-data.
API-versionering og bagudkompatibilitet
iBinders API er i øjeblikket version 1.0. For at sikre bagudkompatibilitet og muliggøre ændringer uden at ødelægge eksisterende integrationer bruges versionsstyring. Version 1.0 har ingen versionsindikator i URL’en (base-URL: https://api.ibinder.com/api). Fremtidige versioner vil have versionsnummer i URL’en, f.eks. https://api.ibinder.com/api/v2.
iBinder bestræber sig på at undgå ændringer, der bryder funktionalitet, og foretrækker i stedet gradvise tilføjelser. Ved behov for ændringer gives der forhåndsbesked, og kunderne får tid til at opdatere deres integrationer. Hver version understøttes i mindst 12 måneder efter, at en ny version er udgivet.
Begrænsning af API-kald (Rate limiting)
For at forhindre misbrug og sikre fair brug anvendes rate limiting og throttling. Begrænsningerne varierer afhængigt af klienttype og forespørgsel. Hvis grænserne overskrides, returneres svaret “429 Too Many Requests”.
Dokumentation og test
Alt, hvad du behøver for at komme i gang, finder du i vores offentlige dokumentation på api-docs.ibinder.com, herunder en færdig Postman-samling til test. Du er meget velkommen til at kontakte os, hvis du har spørgsmål.