Før du begynner
Opprett et eget personlig tilgangstoken og lagre det utenfor kildekontroll. Brukeren må ha rettighetene som trengs for handlingene integrasjonen skal utføre.
1. Åpne API-dokumentasjonen
Fra Agent setup åpner du OpenAPI explorer eller OpenAPI JSON. Les gjeldende forespørselsfelt, svarskjemaer og autentiseringskrav for operasjonen du trenger.
2. Still inn autentisering og kontekst
Send bearer-tokenet i Authorization-headeren. Bruk dokumenterte oppslagsoperasjoner for å finne tillatte identifikatorer for virksomhet, arbeidsflate og leverandørkonto. Ikke kopier identifikatorer fra eksempler for en annen merkevare.
3. Test lesing før skriving
Start med en leseforespørsel og kontroller kontokonteksten. Håndter feil og asynkrone statuser eksplisitt. Før du gjentar en skriveforespørsel med usikkert resultat, kontroller om handlingen allerede skjedde.
4. Opprett oppsett med Copy bootstrap ved behov
Copy bootstrap i Agent setup oppretter et eget token for integrasjonen. Bruk det når du vil opprette tilgangen, og lagre hemmeligheten trygt. Det er ikke bare kopiering av offentlig dokumentasjon.
Kontroller resultatet
Kontroller integrasjonens leseresultat og rettigheter før du lar integrasjonen publisere, sende meldinger eller gjøre andre endringer. Bruk API-skjemaet som fasit for felt og støttede operasjoner.
Hvis noe ikke fungerer
Ved autentiseringsfeil kontrollerer du token og header. Ved rettighetsfeil kontrollerer du medlemskap og rettigheter. Ved valideringsfeil sammenligner du forespørselen med gjeldende OpenAPI-skjema.