API-løsninger for iBinder
Integrer enkelt med eksterne systemer
Sjekkliste før integrasjon:
- Hvilke integrasjonsmuligheter har det andre systemet? (API, import/eksport, webhooks osv.)
- Er teknisk kompetanse tilgjengelig? (Internt utviklingsteam eller ekstern konsulent med API-erfaring)
- Hvilken type informasjon skal utveksles? (f.eks. dokumenter, metadata, prosjekter, brukere)
- Hvor ofte skal informasjonen synkroniseres? (Kontinuerlig, daglig, manuelt)
- Trengs toveisintegrasjon? (Skal begge systemene kunne lese og skrive?)
Merk: Vi anbefaler kun å bruke våre API-er dersom dere har teknisk kompetanse og erfaring med API-integrasjon. iBinder tilbyr ikke støtte for kode eller feilsøking av klientimplementasjoner.
Swagger
iBinder API er offentlig tilgjengelig på:
Autentisering
Vi bruker klientlegitimasjonsflyt (client credentials flow) for autentisering, der hver klient er unikt knyttet til deres kundemiljø (tenant). Kontakt vår support for å få deres klientopplysninger.
Presigned URL-opplasting
iBinder bruker presigned URL-er for filopplasting. Dette betyr at klienten får en midlertidig lenke med tilgangsrettigheter og kan laste opp filer direkte til lagringen uten å gå via API-et. Dette gir en effektiv og sikker opplasting, styrt av begrensningene i Azure Blob Storage.
Format på forespørsler og svar
Kun JSON støttes for request- og response-data.
API-versjonering og bakoverkompatibilitet
iBinders API er for tiden i versjon 1.0. For å sikre bakoverkompatibilitet og muliggjøre endringer uten å bryte eksisterende integrasjoner brukes versjonshåndtering. Versjon 1.0 har ingen versjonsindikator i URL-en (base-URL: https://api.ibinder.com/). Fremtidige versjoner vil ha versjonsnummer i URL-en, f.eks. https://api.ibinder.com/v2.
iBinder forsøker å unngå endringer som bryter eksisterende funksjonalitet, og foretrekker i stedet trinnvise tillegg. Ved behov for endringer gis forhåndsvarsel, og kundene får tid til å oppdatere integrasjonene sine. Hver versjon støttes i minst 12 måneder etter at en ny versjon er lansert.
Begrensning av API-kall (Rate limiting)
For å forhindre misbruk og sikre rettferdig bruk, brukes rate limiting og throttling. Begrensningene varierer avhengig av klienttype og forespørsel. Ved overskridelse returneres svaret “429 Too Many Requests”.
Dokumentasjon og testing
Vi tilbyr også dokumentasjon i PDF-format og har en ferdig Postman Collection for å forenkle testing og implementering. Ta gjerne kontakt dersom dere ønsker tilgang til dokumentasjonen eller har andre spørsmål!