Підключення WordPress до soge.dk
Плагіни Lynbro для WordPress отримують з soge.dk дані про данські транспортні засоби (DMR) і компанії (CVR). Вони підключаються API-ключем, який ви створюєте для свого сайту й вставляєте у WordPress — soge.dk ніколи не отримує доступу до вашого сайту.
Які плагіни це використовують
- Lynbro Soge Lookup — Блоки й шорткоди пошуку за номерним знаком/VIN і CVR, а також автозаповнення даних компанії у WooCommerce та популярних плагінах форм.
- dk-accounting — Поле CVR у кошику WooCommerce: клієнт вводить номер CVR, а назва компанії, адреса й номер ПДВ заповнюються самі.
Налаштування за чотири кроки
- Створіть безкоштовний акаунт soge.dkЗареєструйтеся з e-mail і підтвердьте код, який ми надішлемо. Картка не потрібна; тариф Free безкоштовний назавжди.
- Створіть API-ключ для цього сайтуВідкрийте сторінку API-ключів. Якщо ви прийшли з плагіна, назва вже заповнена як "ваш-сайт.dk — WordPress". Натисніть «Створити ключ» і скопіюйте його — він показується лише один раз. Один ключ на один сайт.
- Вставте ключ у WordPressУ WordPress відкрийте Налаштування → Soge Lookup (або вкладку «З'єднання» плагіна), вставте ключ у поле API-ключа й збережіть. Ключ зберігається на вашому сервері в зашифрованому вигляді і ніколи не потрапляє в браузер відвідувачів.
- Перевірте з'єднанняНатисніть «Зберегти й перевірити». Плагін викликає GET /api/v1/me і показує акаунт, тариф, залишок квоти та дані, які входять у ваш тариф. Цей виклик безкоштовний і не витрачає квоту.
Що надсилається на soge.dk
- Лише те, що шукають: номерний знак, VIN або номер CVR, введений у блок чи форму.
- Ваш API-ключ у заголовку X-API-KEY, а також IP-адреса й User-Agent вашого сервера (WordPress надсилає "WordPress/<версія>; <ваш сайт>").
- Жодних персональних даних відвідувачів, cookie, користувачів WordPress, паролів чи доступу до бази даних. soge.dk ніколи не підключається до вашого сайту — усі виклики йдуть від вашого сервера до soge.dk.
Як ключ прив'язаний до сайту
Ключ працює одночасно з обмеженої кількості серверів (1 на Free, більше на платних тарифах). Місце сервера звільняється після години бездіяльності, тож переїзд на інший хостинг чи staging-копія працюють далі. Якщо межу досягнуто, відхиляється лише зайвий сервер (помилка device_limit) — сам ключ ніколи не блокується.
Що входить у кожен тариф
| Безкоштовно | Starter | Бізнес | Pro | |
|---|---|---|---|---|
| API-викликів / місяць | 1.500 | 6.000 | 30.000 | 100.000 |
| CVR-пошуків у кошику / місяць | 1.000 | 10.000 | 50.000 | 200.000 |
| Запитів / хвилину | 20 | 180 | 600 | 1.200 |
| Серверів на ключ | 1 | 2 | 4 | 10 |
| Власники (ownership) | — | Так | Так | Так |
| Фінзвітність (financials) | — | Так | Так | Так |
| Історія авто (пробіг, техогляди, страховка…) | — | Так | Так | Так |
Free зупиняється на місячній квоті (помилка quota_exceeded, HTTP 402) і відновлюється 1-го числа. Платні тарифи працюють і понад квоту. Ціни: дивіться тарифи.
Власники та фінзвітність
GET /api/v1/cvr/{cvr}/ownership (власники, дочірні й пов'язані компанії) і GET /api/v1/cvr/{cvr}/financials (виручка, прибуток, власний капітал і активи з річних звітів, порівняння за два роки) входять у Starter, Business і Pro. Ключ Free отримує HTTP 403 з кодом scope_missing — плагін тоді просто не показує ці розділи.
CVR-пошук у кошику (dk-accounting)
GET /api/v1/checkout/cvr/{cvr} повертає назву компанії, адресу, поштовий індекс, місто, номер ПДВ (DK + CVR) і чи компанія активна — з тими самими назвами полів, що й cvrapi.dk (name, address, zipcode, city, vat). Працює без API-ключа: на сервер 20/хв і 500/добу, на сайт 100/добу (передайте адресу сайту в заголовку X-Lynbro-Site). З ключем, зокрема Free, у ключа своя квота для кошика (1.000/місяць на Free), яка не витрачає ваші API-виклики.
curl -H "X-Lynbro-Site: https://your-shop.dk" https://soge.dk/api/v1/checkout/cvr/10007127
{"data": {"cvr": "10007127", "name": "…", "address": "…", "zipcode": "…", "city": "…",
"vat": "DK10007127", "status": "NORMAL", "active": true, …},
"meta": {"tier": "keyless", "remaining": 99}}
Коди помилок
Усі помилки мають однакову форму. Текст повідомлення залежить від заголовка Accept-Language (da, en або uk).
{"error": {"code": "scope_missing", "message": "…",
"details": {"scope": "companies:ownership", "upgrade_url": "https://soge.dk/en/pricing"}}}
| Код | HTTP | Що означає |
|---|---|---|
invalid_key | 401 | Ключа немає, він введений з помилкою або відкликаний. Скопіюйте його знову або створіть новий. |
scope_missing | 403 | Ваш тариф не містить цих даних (details.scope). Змініть тариф, або плагін пропустить розділ. |
device_limit | 403 | Ключ уже використовується на стількох серверах, скільки дозволяє тариф. Один ключ на один сайт. |
quota_exceeded | 402 | Місячну квоту тарифу Free вичерпано (details.resets_at). |
rate_limited | 429 | Забагато запитів за хвилину чи добу. Зачекайте Retry-After секунд. |
not_found | 404 | Немає авто чи компанії з таким номером. |
invalid_cvr | 422 | Номер CVR має складатися рівно з 8 цифр. |
upstream_unavailable | 503 | Державний реєстр не відповів. Повторіть трохи пізніше. |
Відкликати або замінити ключ
На сторінці API-ключів або в кабінеті: «Відкликати» зупиняє ключ одразу. «Використати для цього сайту (нове значення)» лишає ключ, але дає йому нове значення — старе перестає працювати миттєво, тож вставте нове у WordPress. Видалення плагіна стирає ключ у WordPress; відкличте його й тут.
Для розробників
OpenAPI: https://soge.dk/api/openapi.json · довідник: https://soge.dk/api-doc · усі виклики сервер-сервер через HTTPS, базова адреса https://soge.dk/api/v1.
curl -H "X-API-KEY: $SOGE_KEY" https://soge.dk/api/v1/me
{"data": {"account_name": "…", "plan": "free", "plan_name": "Free",
"quota": {"unit": "calls", "used": 12, "limit": 1500, "resets_at": "…", "hard_stop": true},
"scopes": ["vehicles:read", "companies:read", "addresses:read", "checkout:cvr"],
"origins": [], "key": {"id": 1, "name": "your-shop.dk — WordPress", "last4": "…"},
"sandbox": false}}