API, datafeed og integrationer

Få jeres tal fra Perfekte Gaveideer ind i egne systemer, og send rabatkoder til os automatisk. Kræver Pro eller Premium.

Kom i gang

  1. Log ind i butikspanelet, og lav en API-nøgle under Konto & team → Integrationer. Nøglen vises kun én gang.
  2. Send nøglen i headeren Authorization: Bearer pg_…. Værktøjer, der ikke kan sende headere (Power BI, Excel, Google Sheets), kan bruge ?key=pg_… i adressen.
  3. Alle svar er JSON. Tilføj format=csv for semikolonsepareret CSV i UTF-8, der åbner direkte i dansk Excel.
curl -H "Authorization: Bearer pg_…" "https://perfektegaveideer.dk/api/partner/v1/statistik?dage=30"

Grænse: 120 kald i minuttet pr. nøgle. Tal for i dag kan ændre sig, indtil dagen er slut. Visninger er en stikprøve, klik er alle klik.

Endpoints

MetodeStiHvadParametre
GET/v1/statistikKlik og visninger pr. dagdage (1–365), format (json/csv)
GET/v1/produkterKlik, visninger og klikrate pr. produktdage, format
GET/v1/feedDagligt datafeed: én række pr. dag × vare × kilde × enhed. Lavet til Power BI, Excel og Google Sheets.dage (standard 90), format
GET/v1/roiHvad I får for pengene de sidste 30 dage–
POST/v1/rabatkoderSend en rabatkode til godkendelseJSON: code, title, terms, ends, eks

Send en rabatkode

curl -X POST "https://perfektegaveideer.dk/api/partner/v1/rabatkoder" \
  -H "Authorization: Bearer pg_…" -H "content-type: application/json" \
  -d '{"code":"JUL20","title":"20 % på alle julegaver","ends":"2026-12-24"}'

Svaret er 201 {"ok":true,"status":"afventer"}. Redaktionen godkender koden, normalt inden for et døgn, og den kommer på jeres butiksside, rabatkodesiden og til jeres følgere.

Felter i datafeedet

  • dato ÅÅÅÅ-MM-DD
  • type klik eller visning
  • vare_id og vare (tom for klik direkte til butikken)
  • pris dagens pris i kr.
  • kilde siden hos os, fx /gave-til/mor/
  • enhed mobil, computer eller tablet
  • antal

Power BI og Excel

Datafeedet giver op til 365 dage og opdateres, hver gang I trykker Opdater. I butikspanelet kan I få koden herunder med jeres egen nøgle sat ind.

  1. Power BI Desktop: Hent data → Tom forespørgsel → Avanceret editor. Indsæt koden, og tryk Udført. Vælg "Anonym", hvis Power BI spørger om adgang.
  2. Excel (Microsoft 365): Data → Hent data → Fra andre kilder → Tom forespørgsel → Avanceret editor.
  3. Google Sheets: skriv =IMPORTDATA("https://perfektegaveideer.dk/api/partner/v1/feed?format=csv&key=pg_…") i en celle. Google opdaterer cirka hver time.
let
    Noegle = "pg_INDSÆT_JERES_NØGLE",
    Kilde = Csv.Document(Web.Contents("https://perfektegaveideer.dk/api/partner/v1/feed", [Query = [format = "csv", dage = "365", key = Noegle]]), [Delimiter = ";", Encoding = 65001, QuoteStyle = QuoteStyle.Csv]),
    Overskrifter = Table.PromoteHeaders(Kilde, [PromoteAllScalars = true]),
    Typer = Table.TransformColumnTypes(Overskrifter, {{"dato", type date}, {"type", type text}, {"vare_id", type text}, {"vare", type text}, {"pris", type number}, {"kilde", type text}, {"enhed", type text}, {"antal", Int64.Type}}, "en-US"),
    Rettet = Table.ReplaceErrorValues(Typer, {{"pris", null}})
in
    Rettet

Gode første visninger i Power BI: klik pr. uge (dato + antal, filtreret på type = klik), top 10 varer, klik pr. kilde og klikrate pr. vare (klik ÷ visninger).

Opskrifter til Zapier og Make

Nye Shopify-rabatkoder sendes til os

Zapier: Trigger "Shopify → New Discount Code" (eller "New Price Rule"). Action "Webhooks by Zapier → POST" til https://perfektegaveideer.dk/api/partner/v1/rabatkoder, payload type JSON, felter code, title og evt. ends, header Authorization: Bearer pg_….

Make: Shopify-modulet "Watch Discount Codes" → HTTP-modulet "Make a request" med samme adresse, header og JSON.

Dagens tal i Slack eller Teams

Sæt en webhook-adresse fra Zapier ("Catch Hook") eller Make ("Custom webhook") i butikspanelet. Hver morgen kl. 6 sender vi gårsdagens klik og visninger. Kobl den til "Slack → Send Channel Message" eller "Microsoft Teams → Post Message".

Ugerapport i Google Sheets

Brug IMPORTDATA med feedet (se ovenfor), eller lad Zapier/Make kalde /v1/statistik?format=csv hver mandag og tilføje rækkerne til et ark.

Kampagner i jeres kalender

Hent /v1/roi den 1. i måneden med "Schedule" i Zapier eller Make, og send nøgletallene til jeres CRM, fx HubSpot eller Pipedrive.

Webhook

Dagligt kl. 6 (dansk tid) sender vi en POST med JSON til den adresse, I gemmer i panelet:

{"kilde":"perfektegaveideer.dk","butik":"<butiksnøgle>","dato":"2026-11-13","klik":42,"visninger":910,"panel":"https://perfektegaveideer.dk/partner/"}

Knappen "Send test" i panelet sender det samme med "test":true. Svarer jeres adresse ikke med 2xx inden for 5 sekunder, springer vi den dag over.

Åbn butikspanelet Se medlemskaber