Anslut ett externt system till Abicart med rätt protokoll, butikskontext och behörigheter.
Den här guiden är till för butiksägare som beställer en integration och utvecklare som bygger den. API-åtkomst ingår i de nuvarande abonnemangen Go, Plus och Pro. Utvecklingsarbete, leverantörsavtal och andra tillägg ingår inte automatiskt. Ett API är ett sätt för system att kommunicera, inte en färdig integration som börjar synkronisera av sig själv.
1. Välj en uppgift och kontrollera metoden
Vanliga användningsområden är produktdata, beställningar, lager, kund-/affärssystem och rapportering. Betalning och frakt kräver också rätt metoder, leverantörsavtal och transaktionshantering. Läs utvecklarguiden för varje metods parametrar och sidoeffekter innan du bygger flödet.
2. Använd rätt protokoll och butik
API:et är JSON-RPC 2.0 via HTTPS eller säker WebSocket (WSS). Det är inte REST bara för att anropet görs över HTTP. HTTPS-slutpunkten är https://admin.abicart.se/backend/jsonrpc/v1. Välj webbutik och, om det behövs, språk/valuta enligt metodens dokumenterade kontext.
Följande skrivskyddade meddelande listar ett begränsat urval av teman. Det illustrerar JSON-RPC-formatet och kräver rätt butikskontext i anropet. Det är inte ett komplett program för autentisering eller synkronisering:
{"jsonrpc":"2.0","id":1,"method":"Theme.list","params":[{"uid":true,"active":true},{"filters":{"/active":true},"limit":10}]}En offentlig läsmetod kan ha annan åtkomst än order- eller kunddata. Att ett offentligt Theme-anrop fungerar bevisar inte att token eller andra behörigheter är korrekt inställda.
3. Hantera AuthToken på ett säkert sätt
Skapa och hantera nyckeln med en behörig administratörsinloggning och ge den ett tydligt syfte. Token ensam räcker inte för att hantera token.
Behandla en AuthToken som en hemlig administratörsnyckel för den tillhörande huvudbutiken och dess underbutiker, med förbehåll för varje API-metods behörighetsregler. Det är inte en personlig, automatiskt begränsad kopia av en viss anställds behörigheter och har inget separat allmänt skrivskyddat läge.
Ge hemligheten endast till den avsedda integratören via en säker kanal. Inkludera den inte i offentlig JavaScript-kod, URL-exempel, versionskontroll eller skärmdumpar till supporten.
Återkalla en token som inte längre ska användas genom att inaktivera eller ta bort den. En kort cache kan påverka den omedelbara effekten. En token har inte samma allmänna livslängd som en vanlig inloggningssession.
4. Hantera svar, listor och återförsök
Matcha svars-ID:t med rätt begäran.
Kontrollera fältet error i JSON-RPC-svaret även om HTTP-anropet lyckades. Läs felkoden och metodens villkor innan du försöker igen.
Paginera listor enligt metodens dokumentation. Den normala listgränsen är 500 om inte metoden anger något annat. Anta inte att den första sidan innehåller hela datamängden.
Håll läsningar och skrivningar separata. Efter en osäker skrivning måste du kontrollera det faktiska resultatet innan du försöker igen, särskilt för beställningar och ekonomiska åtgärder.
Ingen gemensam siffra för förfrågningar per sekund anges här. Följ metoden och driftvillkoren i den aktuella dokumentationen. Vid felsökning, samla in metoden, anonymiserat felobjekt, tidsstämpel och butikskontext, men inga hemligheter eller onödiga kunddata.
Snabbstart
Definiera uppgiften och verifiera rätt metod i utvecklarguiden.
Välj butik, protokoll och nödvändiga behörigheter.
Börja med en begränsad läsning och kontrollera felet/resultatet.
Bygg paginering, behörighetskontroller och säkra återförsök före en skrivsynkronisering.
Abonnemang och åtkomst
API:et är tillgängligt i Go, Plus och Pro. Metodbehörigheter, rätt kontext för huvudbutik/underbutik och leverantörsvillkor måste fortfarande uppfyllas. AuthToken är en administratörsnyckel för den tillhörande butiksfamiljen, inte en personlig behörighetsprofil. API-åtkomst inkluderar inte automatiskt utveckling eller externa tjänster.