Kom igång med CalcWires API

1. Ordna konto och API-åtkomst

Kontakta info@calcwire.se. En administratör registrerar klienten i API-åtkomst och väljer ansvarig användare, företag och behörigheter. Du behöver en Ed25519-nyckel; bara den publika nyckeln registreras. Behåll den privata nyckeln i din egen säkra miljö.

2. Hämta en kortlivad token

Skicka en signerad JWT till POST /api/v1/api-client/token. Använd grant_type client_credentials och client_assertion_type urn:ietf:params:oauth:client-assertion-type:jwt-bearer. JWT-headern anger alg EdDSA och kid från registreringen. Claims innehåller iss och sub med nyckel-ID, unikt jti, company_id, iat och exp (högst 60 sekunder efter iat), samt aud som exakt matchar registreringens tokenadress. Svaret innehåller access_token med 300 sekunders giltighet.

3. Kontrollera identiteten

Använd Bearer-token för GET /api/v1/api-client/me. Kontrollera att identitet och företag är rätt innan du skriver projektdata. 401 betyder att autentiseringen behöver kontrolleras; 403 betyder att åtkomst saknas. Utöka inte behörigheter automatiskt.

4. Läs schemat och välj ett provprojekt

API-referensen och OpenAPI-filen finns bakom behörighet på /api-docs och /api-docs/openapi.json. Be administratören om åtkomst till referensen; en begränsad projektklient har inte automatiskt tillgång till den. Följ aktuella scheman och det importarbetsflöde som tillhandahålls vid anslutningen. Börja med ett separat provprojekt och uttryckligen godkända ritningsfiler.

5. Bygg, granska och lämna över

Läs tillbaka sparade data och följ projektets återstående granskningar, inklusive visuella jämförelser. Vid osäkert svar på ett skrivande anrop: kontrollera projektets tillstånd innan du försöker igen. Lämna ett granskningsbart resultat och tydliga återstående frågor.

Första läsanropet

Efter tokenutbytet: sätt CALCWIRE_ACCESS_TOKEN till den utfärdade tokenen i din lokala miljö. Exemplet använder curl i ett POSIX-skal.

curl --fail-with-body \
  -H "Authorization: Bearer $CALCWIRE_ACCESS_TOKEN" \
  https://www.calcwire.se/api/v1/api-client/me

Öppna API-referensen (inloggning och behörighet krävs) ↗