gyk.dk
Kom i gang

Forbind et WordPress-websted med gyk.dk

Pluginnet Lynbro Short Links & QR giver dine indlæg, sider og produkter et kort link og en printklar QR-kode og viser, hvor mange der kom ind via hver af dem. Det taler kun med gyk.dk via en API-nøgle, du opretter til webstedet — gyk.dk får aldrig adgang til dit WordPress.

1. Opret en gratis gyk.dk-konto

Tilmeld dig med din e-mail og et dansk mobilnummer. Gratis-abonnementet omfatter API'et: 50 links, 10 nye links om dagen og 10.000 klik om måneden med fuld statistik. Betalte abonnementer hæver grænserne.

person_addOpret konto

2. Opret en API-nøgle til webstedet

Tryk på “Åbn siden med API-nøgler” i pluginnet: formularen åbner med webstedets navn, adresse og de to tilladelser udfyldt. Behold flueben ved begge — links:write (opret og ret links) og stats:read (vis klik) — og tryk på “Generer ny nøgle”.

https://gyk.dk/dashboard/api/keys/new?name=<your-site.dk>&scopes=links:write,stats:read&source=wordpress

keyÅbn siden med API-nøgler

3. Indsæt nøglen og signeringsnøglen i WordPress

Kopiér API-nøglen (gyk_live_…) og signeringsnøglen til webhooks (gyk_whsec_…) — begge vises kun én gang. Indsæt dem på pluginnets forbindelsesside. Mistet dem? Tryk på “Ny nøgleværdi” eller “Ny signeringsnøgle” ved nøglen.

4. Test forbindelsen

Tryk på “Gem og test”. Pluginnet kalder GET /api/v1/me og viser kontoen, abonnementet, månedens forbrugte klik samt nøglens tilladelser og websteder.

Hvad der sendes til gyk.dk

Når et link oprettes eller ændres: adressen på indlægget eller produktet, titlen og de UTM-parametre, du har valgt. Med hvert kald: dit websteds adresse, så nøglen kun virker for dit websted. Intet om dine besøgende eller brugere. QR-billedet hentes kun fra gyk.dk på sider, hvor du har indsat QR-blokken.

Hvad gyk.dk sender tilbage

Hvis du slår notifikationer til i pluginnet, sender gyk.dk link.broken (destinationen svarer ikke længere) og link.delete til dit websted. Hver er signeret med din signeringsnøgle (X-Lynbro-Signature). Pluginnet afviser alt, der er usigneret eller ældre end fem minutter, og henter linket igen fra gyk.dk, før det ændrer noget.

Sådan afbryder du forbindelsen

Tryk på “Tilbagekald” ved nøglen på API-siden: pluginnet holder straks op med at virke, og notifikationer til webstedet stopper. Afbrydelse i WordPress sletter kun nøglen dér — tilbagekald den også her. Dine links bliver på gyk.dk.

Hvis noget går galt

401 invalid_key Nøglen blev ikke accepteret — den er tilbagekaldt eller skrevet forkert. Opret en ny nøgle.
403 scope_missing Nøglen mangler en tilladelse. Opret en nøgle med flueben ved begge tilladelser.
403 origin_mismatch Nøglen hører til et andet websted. Opret en nøgle til dette websted (eller tilføj adressen til nøglens websteder).
403 phone_verification_required Din gyk.dk-konto har endnu ikke bekræftet e-mail og dansk mobilnummer. Log ind på gyk.dk og bekræft dem; nøglen virker med det samme.
402 quota_exceeded Abonnementets grænse for links er nået. Opgrader, eller slet links, du ikke længere bruger; dagsgrænsen nulstilles ved midnat UTC.
429 rate_limited For mange forespørgsler på én gang — pluginnet venter og prøver selv igen.

For udviklere

Kald foregår server-til-server med nøglen i X-API-Key (eller Authorization: Bearer) og webstedets adresse i X-Lynbro-Site. Hvert POST kan have en Idempotency-Key: en gentagelse inden for 24 timer returnerer det første resultat i stedet for at oprette et link til. Fejl kommer som {"error": {"code", "message", "details"}} med beskeden på sproget fra Accept-Language (da, en, uk). Webhooks har X-Lynbro-Timestamp, X-Lynbro-Event-Id og X-Lynbro-Signature; path er stien i din webhook-URL plus eventuel query-streng.

X-API-Key: gyk_live_…
X-Lynbro-Site: https://your-site.dk
Idempotency-Key: <uuid>
X-Lynbro-Timestamp: 1763380000
X-Lynbro-Event-Id: 9b2f…
X-Lynbro-Signature: v1=hex(HMAC-SHA256(signing_secret, timestamp + "." + "POST " + path + "." + raw_body))

Alle API-endpoints · OpenAPI