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?)
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.
Swagger
iBinder API er offentligt tilgængeligt på:
Godkendelse
Vi bruger “client credentials flow” til godkendelse, hvor hver klient er unikt knyttet til jeres kundemiljø (tenant). Kontakt vores support for at få jeres klientoplysninger.
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/). Fremtidige versioner vil have versionsnummer i URL’en, f.eks. https://api.ibinder.com/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
Vi tilbyder også dokumentation i PDF-format og har en færdig Postman Collection for at gøre test og implementering lettere. Kontakt os gerne, hvis I ønsker adgang til dokumentationen eller har andre spørgsmål!