Overview

Al kommunikation med Clerks AI sker via vores superhurtige REST API.

Uanset webshop-platformen kan Clerk altid integreres via API eller med vores Clerk.js -løsning, der foretager API-kald fra frontend.

Vi bygger derefter udvidelser og integrationer, der samler funktioner fra API’en og Clerk.js for at gøre integrationen problemfri.

API #

API’en er hjørnestenen i Clerk’s funktionalitet.

https://api.clerk.io/v2

Clerk.js #

Clerk.js gør det hurtigt og behageligt at integrere Clerk.io’s tjenester i enhver butiksfrontend.

Clerk.js gør alt det tunge arbejde, som f.eks. at lave netværksanmodninger, elegant håndtere fejl, rendere i DOM’en og anvende klik- og adfærdssporing ud af boksen.

<!-- Start of Clerk.io E-commerce Personalisation tool - www.clerk.io -->
<script type="text/javascript">
  (function(w,d){
    var e=d.createElement('script');e.type='text/javascript';e.async=true;
    e.src='https://cdn.clerk.io/clerk.js';
    var s=d.getElementsByTagName('script')[0];s.parentNode.insertBefore(e,s);
    w.__clerk_q=w.__clerk_q||[];w.Clerk=w.Clerk||function(){ w.__clerk_q.push(arguments) };
  })(window,document);

  Clerk('config', {
    key: 'insert_api_key'
  });
</script>
<!-- End of Clerk.io E-commerce Personalisation tool - www.clerk.io -->

Udvidelser #

Disse installeres på platformen som pakker, der samler feedet, API-kald og Clerk.js.

De kan tage sig af synkronisering**, sporing og indsættelse af uddrag.

Eksempler er Magento2, WooCommerce og Prestashop.

Da udvidelsen fysisk vil være på din server, kan du udvide eller ændre den i koden, som du finder det passende. Bare sørg for at holde dine ændringer adskilt fra kernefilerne for at undgå at overskrive dem, når du opdaterer til en ny version.

De fleste udvidelser synkroniserer data ved at oprette endpoints på webshoppen, som derefter tilgås med den offentlige og private nøgle, ligesom når man foretager CRUD-kald. Når du kører en datasynkronisering, får Clerks importør adgang til hvert endpoint for at modtage dataene i JSON-format gennem paginering.

https://awesomestore.com/clerk/product?key=insert_public&private_key=insert_private&page=1&limit=100
https://awesomestore.com/clerk/category?key=insert_public&private_key=insert_private&page=1&limit=100
https://awesomestore.com/clerk/order?key=insert_public&private_key=insert_private&page=1&limit=100

Integrationer #

Disse bruger webshop-platformens API til at synkronisere data, mens snippets skal indsættes manuelt i temafilerne.

Eksempler her er Shopify, BigCommerce og Lightspeed.

Integrationer hostes på Clerk’s servere, så selv om du ikke kan ændre deres kode, indeholder de forskellige konfigurationsmuligheder fra datasiden.

Hvis vi har en udvidelse eller integration til din platform, anbefaler vi, at du bruger den til at forenkle i det mindste dele af installationen.

Du kan stadig vælge kun at bruge den til at synkronisere data og derefter bruge API’en eller brugerdefinerede uddrag til frontend. Med andre ord, tænk på dem som værktøjssæt, som du kan bruge i den grad, du finder det passende.

Valg af opsætning #

En Clerk.js-integration er ofte den hurtigste og giver de ikke-tekniske medarbejdere i din virksomhed langt mere kontrol over opsætningen efter integrationen.

Du behøver heller ikke at bekymre dig om at spore og tilføje serverbelastning, da Clerk.js fungerer i frontend, mens siden indlæses.

API-opsætninger anbefales, hvis du har en masse tilpasset forretningslogik, du skal anvende.

Hvis du f.eks. udvikler en B2B-butik med unikke priser og kataloger for hver indlogget kunde, er det sandsynligvis nemmere at foretage API-kald på serversiden og anvende forretningslogikken, når Clerk har returneret resultater.

Og hvis du hurtigt skal skifte fra en anden API til Clerk, er det ofte meget hurtigere at udskifte og omkonfigurere API-kald end at lave en Clerk.js-installation, i hvert fald til at begynde med. Endelig, hvis du bygger en app, er det at bruge API’en den bedste måde at forbinde den med Clerk.