API opinii dla e-commerce
API opinii dla e-commerce to most między Twoim sklepem a systemem zbierania recenzji VeroRate. REST API przyjmuje zamówienia po realizacji, inicjuje zaproszenia do opinii z tokenem weryfikacyjnym i udostępnia zweryfikowane recenzje do widgetów lub własnego frontendu. Niezależnie od platformy — Shoper, PrestaShop, WooCommerce czy autorskie rozwiązanie — integracja opiera się o JSON, klucz API i HTTPS.
Architektura API VeroRate
Publiczny endpoint biznesowy: POST /api/v1/orders.php — przekazanie zamówienia z kluczem API w nagłówku Authorization. Panel administracyjny: REST pod /api/admin/* — moderacja, profil sklepu, billing (sesja cookie + CSRF). Publiczny profil: GET /api/shop-profile.php?slug=... — opinie approved do własnego renderowania.
Widget widget.js.php to alternatywa bez programowania — pobiera dane z wewnętrznego API profilu. Developerski flow daje pełną kontrolę nad UI recenzji na stronie sklepu.
Wszystkie endpointy działają przez HTTPS. Klucz API generujesz w /panel/onboarding — widoczny jednorazowo, potem przechowywany jako hash.
Przekazywanie zamówień — POST orders
Body JSON zawiera: order_id (unikalny w sklepie), customer_email, opcjonalnie customer_name, products[] z sku i name, ordered_at, delivered_at. Po sukcesie VeroRate tworzy zaproszenie i — według konfiguracji — wysyła e-mail do klienta.
Wywołuj endpoint po statusie „dostarczone” lub „zrealizowane” — nie przy samej płatności, chyba że sprzedajesz usługi cyfrowe z natychmiastową fulfillment.
Idempotencja: powtórne wysłanie tego samego order_id nie duplikuje zaproszeń — API zwraca informację o istniejącym rekordzie.
Autoryzacja i bezpieczeństwo
Klucz API w nagłówku: Authorization: Bearer YOUR_API_KEY. Klucz jest per sklep — multi-shop w planach Pro/Business ma osobne klucze. Rotacja klucza: wygeneruj nowy w panelu, zaktualizuj sklep, unieważnij stary.
Nigdy nie commituj klucza do repozytorium frontendu — wywołania orders idą z backendu sklepu (server-to-server), nie z przeglądarki klienta.
Rate limiting i limity planu abonamentowego kontrolują liczbę zaproszeń miesięcznie — odpowiedź API zawiera informację o zużyciu.
Pobieranie opinii — shop-profile API
GET /api/shop-profile.php?slug=twoj-sklep zwraca JSON: dane sklepu, VeroScore, lista opinii approved z badge weryfikacji, odpowiedziami sklepu i datami. Idealne do customowego widgetu w React/Vue na stronie sklepu.
Cache po stronie sklepu zalecany 5–15 minut — zgodnie z polityką świeżości danych. Widget VeroRate robi to automatycznie.
Filtrowanie po product_sku możliwe po stronie klienta API — wyświetl na karcie produktu tylko recenzje z matching SKU.
Integracja z platformami e-commerce
Shoper: webhook lub moduł cron po zmianie statusu zamówienia → POST do VeroRate. WooCommerce: hook woocommerce_order_status_completed. PrestaShop: moduł lub override klasy OrderHistory.
IdoSell, Shopify (przez middleware), Magento — ten sam wzorzec: event „zamówienie zrealizowane” → server-side POST z danymi klienta i produktów.
W panelu onboarding znajdziesz checklistę integracji i przykładowy payload JSON. Testowe zamówienie wysyłasz curl lub Postman przed podpięciem produkcji.
Obsługa błędów i monitoring
Kody HTTP: 201 created, 400 validation error, 401 invalid API key, 429 limit exceeded, 500 server error. Loguj odpowiedzi po stronie sklepu — retry z exponential backoff przy 5xx.
Alertuj zespół dev, gdy error rate rośnie — utracone zamówienia to utracone zaproszenia i opinie.
Panel VeroRate pokazuje historię zaproszeń — weryfikujesz, czy API faktycznie dostarcza dane bez grzebania w logach sklepu.
Od API do widgetu — wybór ścieżki
Szybki start: tylko POST orders + widget JS — zero frontend dev. Pełna kontrola: POST orders + shop-profile API + własny komponent UI. Hybrid: widget na stronie głównej, custom API na karcie produktu.
Oba warianty korzystają z tego samego backendu VeroRate — zmiana strategii nie wymaga migracji danych.
Dokumentacja endpointów rozwijana jest w panelu /panel/api — opis pól, przykłady curl, informacja o limitach planu.
FAQ
Najczęstsze pytania na temat: api opinii dla e-commerce.
Czy API jest dostępne w planie Free?
Tak. Klucz API i endpoint orders działają od planu Free — limit to 30 zaproszeń miesięcznie. Wyższe plany zwiększają limity.
Czy mogę wywoływać API z frontendu sklepu?
Nie zalecamy — klucz API ujawniony w JS byłby publiczny. Wywołuj POST orders wyłącznie z backendu sklepu.
Jaki format danych akceptuje API?
JSON (Content-Type: application/json). Szczegóły pól w panelu /panel/api i dokumentacji onboarding.
Czy VeroRate ma gotowe wtyczki?
Integracja odbywa się przez uniwersalne REST API. Gotowe wtyczki platform mogą pojawić się w roadmap — na start wystarczy kilkanaście linii kodu w webhooku sklepu.
Powiązane tematy
Wygeneruj klucz API w panelu VeroRate
Załóż konto za darmo, podłącz sklep przez API i zacznij zbierać opinie potwierdzone zakupem. Pierwsze zaproszenia możesz wysłać już tego samego dnia.