Skip to main content
OpenWrench Buyer API ger anläggningsoperatörer programmatisk åtkomst till allt på köparsidan av plattformen: skapa och följa arbetsordrar, hantera tillgångar och platser, granska offerter och fakturor, övervaka förebyggande underhåll och söka i ditt leverantörsnätverk.

​
Bas-URL

Alla köparslutpunkter ligger under /v1/buyer/.

​
Autentisering

Varje förfrågan måste innehålla två rubriker: X-API-KEY (din API-nyckel, utfärdad per köparkontakt) och OW-KEY (den delade hemligheten från OpenWrench som utfärdas tillsammans med den). Nyckeln avgränsar automatiskt varje förfrågan till ditt företag. Du ser bara dina egna data. Förfrågningar som saknar någon av rubrikerna returnerar 401.
För att få en API-nyckel och en delad hemlighet, kontakta support@useopenwrench.com. Använd GET /v1/buyer/me för att inspektera identiteten (kontakt, anläggning, företag) bakom din nyckel. Nycklar löper inte ut av sig själva. För att rotera en, begär ett nytt par nyckel/delad hemlighet från supporten, driftsätt det nya paret och be sedan supporten återkalla det gamla.
Sektionen Internal Teams API längre ner i den här fliken använder en separat partner-API-nyckel. Din köparnyckel autentiserar inte mot slutpunkterna under /v1/partners/. Se Introduktion till Internal Teams API för detaljer.

​
Hastighetsgränser

10 förfrågningar per 20-sekundersfönster per nyckel. Utöver det får du 429 Too Many Requests: vänta minst 20 sekunder innan du försöker igen, och sprid ut bakgrundsjobb (till exempel fullständiga sidindelade exporter) så att de håller sig under gränsen.

​
Hålla arbetsordrar synkroniserade

Om din integration speglar arbetsordrar till ett annat system (ett ärendehanteringsverktyg, ett ERP, ett datalager), bygg den på push, inte polling:
  1. Registrera en webhook-slutpunkt. OpenWrench skickar händelserna workorder.create, workorder.status_update och workorder.new_note när de inträffar.
  2. Vid varje händelse, hämta just den arbetsordern med GET /v1/buyer/work_order/work_orders/{id}.
  3. Använd GET /v1/buyer/work_order/work_orders för ad hoc-frågor, den engångsvisa initiala laddningen och tillfällig avstämning, med ett smalt filter och en liten sida.
Polla inte list-slutpunkten enligt schema för att hitta nya eller ändrade arbetsordrar. Den är den dyraste läsningen i API:et, den är långsam på stora konton och den konkurrerar med ditt riktiga arbete om hastighetsgränsen. Se Arbetsordrar för detaljerna.

​
Svarshöljet

Svar för enskilda entiteter:
Listsvar lägger till ett totalt count:
Fel:
401 betyder att en nyckel saknas eller är ogiltig; 400 täcker felaktig indata, felaktiga filter och behörighetsavslag; 429 är hastighetsgränsen.

​
Paginering och filtrering

List-slutpunkter accepterar offset, limit (standard 10, max 25), sort_by och order (asc | desc). Ytterligare frågeparametrar behandlas som fältfilter. Skicka ett fältnamn med ett värde (kommaseparera flera värden) för att filtrera resultatuppsättningen. Referensens sida för varje slutpunkt listar dess viktigare filter.

​
Datumformat

De flesta tidsstämplar är ISO 8601-strängar med offset (t.ex. 2026-08-14T13:05:22.000-07:00); vissa databastidsstämpelfält serialiseras som yyyy-MM-dd HH:mm:ss.S. Rena datum är yyyy-MM-dd. När du skickar datum-tider, använd ISO 8601.

​
Detaljerade guider

Guiderna i den här fliken går igenom varje del av API:et i detalj, med payloads, statusmodeller och integrationsmönster:

Arbetsordrar

Skapa, filtrera, tilldela om, avsluta. Statusmodell, anteckningar och problemtyper.

Webhooks

Händelser för skapad arbetsorder, statusändring och ny anteckning skickade till din slutpunkt.

Servicebesök

Besöksbevis: arbetsloggar, faktisk arbetstid och teknikeruppgifter.

Tillgångar och platser

Platser, regioner, tillgångstyper, modeller, mätare och köldmediespårning.

Fakturor

Godkännandeflödet, AP-synk, plattade exporter och massuppdateringar.

Offerter och förslag

Läs leverantörsofferter och stäm av dem mot fakturor.

Planerat underhåll

Läs scheman, hoppa över körningar och driv PM från en extern schemaläggare.

Leverantörsnätverk

Sök i ditt nätverk och rangordna privata nätverksleverantörer för utskick.

Platsbesiktningar

Genomgångar och arbetsordrar som skapas av deras iakttagelser.

Filer och bilagor

Ladda upp en gång, referera överallt, ladda ner bevis.

Konto och verktyg

Ping, nyckelidentitet, användarprovisionering och växelkurser.