Udviklere

Spørg en butik, hvad den kan lave, fra din egen assistent.

Hver butik på Specify svarer på et API bygget til AI-assistenter. Det giver det samme svar, som butikken giver en kunde. Intet bliver gættet undervejs.

Det samme svar som butikken

En assistent spørger, om en butik kan lave noget. API'et spørger den samme kode, som butikken spørger.

Så de to svar forbliver ens. En test sender begge det samme spørgsmål og sammenligner svarene byte for byte.

Et nej kommer med butikkens egne ord. En pris er butikkens eget tal eller slet intet tal.

Fem ruter

Hver sti begynder med butikkens navn, dens slug. Ingen rute kræver en API-nøgle.

GET /api/agent/v1/{merchantSlug}/capability
Det, butikken kan lave: valg, enheder og intervaller. Og de produkter, du kan spørge om.
POST /api/agent/v1/{merchantSlug}/offer
Send valgte muligheder. Få ja eller nej tilbage, grundene og prisen.
POST /api/agent/v1/{merchantSlug}/offer/from-intent
Send en sætning i stedet. Få det samme svar, og hvad der blev forstået.
POST /api/agent/v1/{merchantSlug}/opportunities
Send en forespørgsel på noget, butikken ikke tilbyder endnu. Butikken svarer på den.
POST /api/agent/v1/{merchantSlug}/orders
Læg en ordre, som en kunde bad om, til den pris, kunden sagde ja til.

OpenAPI-dokumentet

Ruterne er beskrevet i ét OpenAPI-dokument. Det laves ud fra koden, så det kan ikke komme ud af trit med den. Det dækker de fem ruter og intet andet.

https://api-dev.specify.digital/openapi/agent.json

Åbn OpenAPI-dokumentet

Det kan du regne med

  • Ingen opfundne priser

    En pris er fast, regnet ud eller kræver et menneske. I det sidste tilfælde sendes intet tal.

  • Én nøgle, én ordre

    Hver ordre har en nøgle, som din kode finder på. Send den igen efter et tabt svar, og du får den samme ordre tilbage.

  • Den pris, kunden sagde ja til

    Angiv den total, kunden sagde ja til. Hvis prisen har flyttet sig, bliver intet lagt. Svaret giver den nye total.

  • Fejl, du kan handle på

    Hver fejl har en fast kode, og hver kode siger, hvad du skal gøre. Koder bliver aldrig omdøbt.

  • Ændringer lægger kun til

    Versionen står i stien. Inden for en version lægger ændringer kun til. En test holder hver ændring op mod den sidst udgivne form.

  • Spørgsmål, ikke en udskrift

    En assistent kan spørge om et valg, butikken ikke viser. Den kan ikke få dem alle oplistet.

API-nøgler

Agent-API'et kræver ingen API-nøgle. Det er bygget til enhver assistent. Hver rute har en grænse pr. adresse. Et travlt svar siger, hvornår du kan prøve igen.

Butikkens egne systemer er noget andet. Ejere og administratorer laver en API-nøgle til hvert af dem. Det sker i administrationen under API-nøgler. En API-nøgle vises én gang og kan tilbagekaldes.

Ikke bygget endnu

API-dokumentationen nævner disse, og det gør vi også.

  • En assistent kan ikke betale for kunden. Kunden betaler på butikkens egen betalingsside.
  • En sætning læses én tur ad gangen. Der er ingen samtale frem og tilbage.
  • En assistent lægger en ordre, som en kunde bad om. Den beslutter ikke selv at købe.

Prøv det mod din egen butik

Sæt en butik op med ét produkt og dets valg. Peg så din assistent på den.

Opret din butik Læs, hvordan det virker

For at tilmelde dig beder vi om din arbejdsmail og dit firmanavn.