Підключення сайту WordPress до gyk.dk
Плагін Lynbro Short Links & QR дає вашим записам, сторінкам і товарам коротке посилання та QR-код для друку й показує, скільки людей прийшло через кожне. Він спілкується з gyk.dk лише через API-ключ, який ви створюєте для сайту, — gyk.dk ніколи не отримує доступу до вашого WordPress.
1. Створіть безкоштовний акаунт gyk.dk
Зареєструйтеся з e-mail і данським мобільним номером. Безкоштовний тариф включає API: 50 посилань, 10 нових на день і 10 000 кліків на місяць із повною статистикою. Платні тарифи збільшують ліміти.
2. Створіть API-ключ для сайту
У плагіні натисніть «Відкрити сторінку API-ключів»: форма відкриється вже з назвою сайту, його адресою та двома дозволами. Залиште обидва позначеними — links:write (створення й зміна посилань) і stats:read (показ кліків) — і натисніть «Згенерувати новий ключ».
https://gyk.dk/dashboard/api/keys/new?name=<your-site.dk>&scopes=links:write,stats:read&source=wordpress
3. Вставте ключ і секрет підпису у WordPress
Скопіюйте API-ключ (gyk_live_…) і секрет підпису вебхуків (gyk_whsec_…) — обидва показуються лише один раз. Вставте їх на екрані «З’єднання» плагіна. Загубили? Натисніть «Нове значення ключа» або «Новий секрет підпису» біля ключа.
4. Перевірте з’єднання
Натисніть «Зберегти й перевірити». Плагін викличе GET /api/v1/me і покаже акаунт, тариф, використані цього місяця кліки, дозволи й сайти ключа.
Що надсилається до gyk.dk
Коли посилання створюється чи змінюється: адреса запису або товару, його назва та вибрані вами UTM-параметри. З кожним запитом: адреса вашого сайту, щоб ключ працював лише для нього. Нічого про ваших відвідувачів чи користувачів. QR-зображення завантажується з gyk.dk лише на сторінках, де ви розмістили блок QR.
Що gyk.dk надсилає у відповідь
Якщо ввімкнути сповіщення в плагіні, gyk.dk надсилатиме на ваш сайт link.broken (адреса призначення перестала відповідати) і link.delete. Кожне підписане вашим секретом (X-Lynbro-Signature). Плагін відхиляє все непідписане або старіше за п’ять хвилин і перед будь-якою зміною заново читає посилання з gyk.dk.
Як відключити
Натисніть «Відкликати» біля ключа на сторінці API: плагін одразу перестане працювати, а сповіщення на сайт припиняться. Відключення у WordPress лише видаляє ключ там — відкличте його й тут. Ваші посилання залишаться на gyk.dk.
Якщо щось пішло не так
401 invalid_key |
Ключ не прийнято — його відкликано або введено з помилкою. Створіть новий ключ. |
403 scope_missing |
Ключу бракує дозволу. Створіть ключ з обома позначеними дозволами. |
403 origin_mismatch |
Ключ належить іншому сайту. Створіть ключ для цього сайту (або додайте цю адресу до сайтів ключа). |
403 phone_verification_required |
Ваш акаунт gyk.dk ще не підтвердив e-mail і данський номер мобільного. Увійдіть на gyk.dk і підтвердьте їх — ключ одразу запрацює. |
402 quota_exceeded |
Ліміт посилань вашого тарифу вичерпано. Перейдіть на вищий тариф або видаліть непотрібні посилання; денний ліміт оновлюється опівночі UTC. |
429 rate_limited |
Забагато запитів одночасно — плагін зачекає й повторить сам. |
Для розробників
Виклики йдуть між серверами: ключ у X-API-Key (або Authorization: Bearer), адреса сайту в X-Lynbro-Site. Кожен POST може мати Idempotency-Key: повтор протягом 24 годин поверне перший результат замість створення ще одного посилання. Помилки приходять як {"error": {"code", "message", "details"}}, повідомлення — мовою з Accept-Language (da, en, uk). Вебхуки мають X-Lynbro-Timestamp, X-Lynbro-Event-Id і X-Lynbro-Signature; path — це шлях вашої URL вебхука разом із query-рядком, якщо він є.
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))