Підключення WordPress до soge.dk

Плагіни Lynbro для WordPress отримують з soge.dk дані про данські транспортні засоби (DMR) і компанії (CVR). Вони підключаються API-ключем, який ви створюєте для свого сайту й вставляєте у WordPress — soge.dk ніколи не отримує доступу до вашого сайту.

Які плагіни це використовують

  • Lynbro Soge Lookup — Блоки й шорткоди пошуку за номерним знаком/VIN і CVR, а також автозаповнення даних компанії у WooCommerce та популярних плагінах форм.
  • dk-accounting — Поле CVR у кошику WooCommerce: клієнт вводить номер CVR, а назва компанії, адреса й номер ПДВ заповнюються самі.

Налаштування за чотири кроки

  1. Створіть безкоштовний акаунт soge.dkЗареєструйтеся з e-mail і підтвердьте код, який ми надішлемо. Картка не потрібна; тариф Free безкоштовний назавжди.
  2. Створіть API-ключ для цього сайтуВідкрийте сторінку API-ключів. Якщо ви прийшли з плагіна, назва вже заповнена як "ваш-сайт.dk — WordPress". Натисніть «Створити ключ» і скопіюйте його — він показується лише один раз. Один ключ на один сайт.
  3. Вставте ключ у WordPressУ WordPress відкрийте Налаштування → Soge Lookup (або вкладку «З'єднання» плагіна), вставте ключ у поле API-ключа й збережіть. Ключ зберігається на вашому сервері в зашифрованому вигляді і ніколи не потрапляє в браузер відвідувачів.
  4. Перевірте з'єднанняНатисніть «Зберегти й перевірити». Плагін викликає 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.5006.00030.000100.000
CVR-пошуків у кошику / місяць1.00010.00050.000200.000
Запитів / хвилину201806001.200
Серверів на ключ12410
Власники (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_key401Ключа немає, він введений з помилкою або відкликаний. Скопіюйте його знову або створіть новий.
scope_missing403Ваш тариф не містить цих даних (details.scope). Змініть тариф, або плагін пропустить розділ.
device_limit403Ключ уже використовується на стількох серверах, скільки дозволяє тариф. Один ключ на один сайт.
quota_exceeded402Місячну квоту тарифу Free вичерпано (details.resets_at).
rate_limited429Забагато запитів за хвилину чи добу. Зачекайте Retry-After секунд.
not_found404Немає авто чи компанії з таким номером.
invalid_cvr422Номер CVR має складатися рівно з 8 цифр.
upstream_unavailable503Державний реєстр не відповів. Повторіть трохи пізніше.

Відкликати або замінити ключ

На сторінці 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}}