Uzņēmumiem › Izstrādātājiem

Izstrādātāju portāls

Logrīki, uzaicinājumi pēc pirkuma, REST API un webhooki — viss, lai savienotu savu e-veikalu ar Godīgas Atsauksmes.

Ātrais sākums

  1. Ienāc biznesa panelī ar Google vai Facebook un piesaisti savu uzņēmumu (darba e-pasts, meta tags, fails vai DNS ieraksts).
  2. Ieliec logrīku mājaslapā — tas strādā arī bez piesaistes.
  3. Sāc aicināt klientus: CSV no paneļa, unikālas saites pasūtījuma e-pastā vai API.
  4. Izveido API atslēgu un webhook, lai atsauksmes nonāktu tavā CRM vai Slack.

Tavs uzņēmuma identifikators (slug) ir profila adreses pēdējā daļa: https://godigasatsauksmes.lv/uznemums/swedbank.

Logrīki

Ielīmē kodu vietā, kur jārāda logrīks. Logrīks ielādējas atsevišķā iframe, tāpēc neietekmē tavas lapas stilus un ātrumu (loading="lazy"), un pielāgo augstumu saturam.

<div class="ga-widget" data-company="swedbank" data-type="carousel"></div>
<script src="https://godigasatsauksmes.lv/widget.js" async></script>
AtribūtsVērtībasApraksts
data-companyslugObligāts. Uzņēmuma identifikators.
data-typemini stars badge carousel list collectorLogrīka veids (noklusētais mini).
data-themedarkTumšam fonam.
data-min1–5Rādīt atsauksmes no šī vērtējuma (karuselim un sarakstam). Kopējais vērtējums vienmēr ietver visas atsauksmes.
data-count1–20Atsauksmju skaits.
Mini miniVērtējums un atsauksmju skaits. Der kājenei, grozam vai produkta lapai.
Zvaigžņu rinda starsViena kompakta rinda — galvenei vai pie cenas.
Nozīmīte badgeNeliela poga ar vērtējumu.
Karuselis carouselJaunākās atsauksmes, ko var šķirstīt. Sākumlapai.
Saraksts listAtsauksmju saraksts — lapai «Atsauksmes».
Novērtē mūs collectorPiecas zvaigznes, kas ved uz atsauksmes formu. Pēc pirkuma lapai.

Ja lapu ielādē dinamiski (React, Vue, SPA), pēc jaunu elementu pievienošanas izsauc window.GodigasAtsauksmes.init(). Bez JavaScript var izmantot tiešu iframe: <iframe src="https://godigasatsauksmes.lv/embed/swedbank?type=mini" …>.

SVG nozīmīte

Attēls ar aktuālo vērtējumu e-pasta parakstam, rēķiniem, Markdown un vietām, kur skripti nav atļauti. Atjaunojas ik pēc 30 minūtēm.

Nozīmītes piemērs

<a href="https://godigasatsauksmes.lv/uznemums/swedbank"><img src="https://godigasatsauksmes.lv/badge/swedbank.svg" alt="Atsauksmes — Godīgas Atsauksmes" height="28"></a>

Uzaicinājumi pēc pirkuma

Uzaicinātās atsauksmes profilā saņem atzīmi «Uzaicināts», un tu redzi, kurš pasūtījums tās atnesa. Ir četri veidi:

VeidsKam derKas sūta e-pastu
CSV vai viens e-pasts biznesa panelīBez izstrādes, periodiskiGodīgas Atsauksmes
API ar e-pastu — POST /invitations ar emailE-veikals, CRM, kaseGodīgas Atsauksmes (ar aizturi)
API bez e-pasta — POST /invitations tikai ar referenceSaite tavā pasūtījuma/piegādes e-pastāTu pats
Parakstīta saite — bez API izsaukumaE-pasta šabloni, kur var izrēķināt HMACTu pats

Godīgas Atsauksmes sūtītais e-pasts satur tavu tekstu, piecas zvaigznes (klikšķis atver formu ar izvēlēto vērtējumu) un atteikšanās saiti. Tekstu, sūtītāja vārdu un aizturi (0–30 dienas) maini panelī. Ja klients ir atteicies, uzaicinājums netiek sūtīts. Klientu e-pastus dzēšam pēc 180 dienām.

Saiti var izveidot jebkur, kur var izrēķināt HMAC-SHA256 — bez API izsaukuma. Slepenā atslēga ir biznesa paneļa sadaļā «Uzaicinājumi». Paraksts tiek rēķināts no virknes {slug}:{reference}:

https://godigasatsauksmes.lv/i/s/{slug}?ref={reference}&sig={hex(HMAC_SHA256(secret, slug + ":" + reference))}

Neobligāti parametri: name (klienta vārds), r (1–5, iepriekš izvēlētais vērtējums — zvaigznēm e-pastā). Katrs reference ir viens uzaicinājums: atkārtots klikšķis atver to pašu.

PHP

$ref  = (string) $order->get_id();
$sig  = hash_hmac('sha256', 'swedbank:' . $ref, GA_LINK_SECRET);
$link = 'https://godigasatsauksmes.lv/i/s/swedbank?ref=' . rawurlencode($ref) . '&sig=' . $sig;

Node.js

import { createHmac } from 'node:crypto';

const ref = String(order.id);
const sig = createHmac('sha256', process.env.GA_LINK_SECRET).update('swedbank:' + ref).digest('hex');
const link = 'https://godigasatsauksmes.lv/i/s/swedbank?ref=' + encodeURIComponent(ref) + '&sig=' + sig;

Python

import hmac, hashlib, urllib.parse

ref = str(order.id)
sig = hmac.new(GA_LINK_SECRET.encode(), f"swedbank:{ref}".encode(), hashlib.sha256).hexdigest()
link = f"https://godigasatsauksmes.lv/i/s/swedbank?ref={urllib.parse.quote(ref)}&sig={sig}"

REST API v1

Bāzes adrese: https://godigasatsauksmes.lv/api/v1. Atbildes ir JSON (UTF-8), laiki — ISO 8601 UTC. Privātajiem galapunktiem sūti API atslēgu, ko izveido biznesa panelī:

Authorization: Bearer ga_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Atslēga dod piekļuvi tikai vienam uzņēmumam. Glabā to serverī — nekad pārlūka kodā vai mobilajā lietotnē. Kļūdas izskatās tā:

HTTP/1.1 401 Unauthorized
{ "error": { "code": "unauthorized", "message": "Trūkst vai nederīga API atslēga." } }

Kodi: 400 invalid_request, 400 invalid_json, 401 unauthorized, 404 not_found, 409 conflict, 429 daily_limit. Saraksti ir lappušu veidā: ?page=1&per_page=20 (līdz 100), atbildē page, per_page, total.

GET/meTavs uzņēmums un vērtējums

Uzaicinājumi

POST/invitationsIzveidot vienu vai līdz 100 uzaicinājumiem
GET/invitationsSaraksts; filtri ?status= un ?reference=
GET/invitations/{id}Viens uzaicinājums
DELETE/invitations/{id}Atcelt, ja vēl nav nosūtīts

Lauki: email (ja nav — tikai saite), name, reference (pasūtījuma nr.; atkārtots pieprasījums ar to pašu vērtību atgriež esošo uzaicinājumu — droši atkārtot), delay_days (0–60, noklusētais no paneļa) vai send_at (ISO laiks).

curl https://godigasatsauksmes.lv/api/v1/invitations \
  -H "Authorization: Bearer $GA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"anna@piemers.lv","name":"Anna","reference":"10045","delay_days":3}'
HTTP/1.1 201 Created
{
  "data": {
    "id": 812,
    "email": "anna@piemers.lv",
    "name": "Anna",
    "reference": "10045",
    "status": "queued",
    "send_at": "2026-11-22 09:14:02",
    "link": "https://godigasatsauksmes.lv/i/3f9c…"
  }
}

Vairāki uzreiz: {"invitations": [{…}, {…}]} — atbildē data ir masīvs tādā pašā secībā. Statusi: queued, sent, opened, reviewed, link (bez e-pasta), duplicate (tas pats e-pasts pēdējās 30 dienās), unsubscribed, invalid, failed, cancelled.

Atsauksmes

GET/reviewsTava uzņēmuma atsauksmes; ?since=2026-11-01T00:00:00Z
POST/reviews/{id}/replyPublicēt vai mainīt atbildi: {"body": "…"}
DELETE/reviews/{id}/replyNoņemt atbildi
{
  "data": [{
    "id": 4211,
    "rating": 5,
    "title": "Ātri un godīgi",
    "body": "Pasūtīju svētdien, pirmdien jau bija klāt…",
    "tags": ["Ātrs serviss"],
    "author": "Anna K.",
    "experience_month": "2026-11",
    "published_at": "2026-11-19T08:12:44Z",
    "invited": true,
    "verified": false,
    "reply": null,
    "url": "https://godigasatsauksmes.lv/uznemums/swedbank#r4211",
    "invitation": { "id": 812, "reference": "10045" }
  }],
  "page": 1, "per_page": 20, "total": 1
}

Publiskie dati (bez atslēgas)

GET/companies?q=220Meklēt uzņēmumus pēc nosaukuma, domēna vai reģ. nr.
GET/companies/{slug}Vērtējums, skaits un sadalījums pa zvaigznēm
GET/companies/{slug}/reviewsPublicētās atsauksmes; ?min_rating=4

Publiskie galapunkti atļauj CORS (Access-Control-Allow-Origin: *) un tiek kešoti 5 minūtes — tos var saukt arī no pārlūka, lai veidotu savu dizainu.

const res = await fetch('https://godigasatsauksmes.lv/api/v1/companies/swedbank');
const { data } = await res.json();
console.log(data.rating, data.review_count, data.distribution);

Webhooki

Iestati URL biznesa paneļa sadaļā «API un webhooki». Par katru jaunu atsauksmi nosūtām POST ar JSON. Atbildi ar 2xx 8 sekunžu laikā; pēdējās piegādes redzamas panelī.

POST /hooks/atsauksmes
GA-Event: review.created
GA-Signature: t=1763540000,v1=5d41402abc4b2a76b9719d911017c592…

{
  "id": "evt_8b1f…",
  "event": "review.created",
  "created_at": "2026-11-19T08:12:45Z",
  "data": {
    "company": { "slug": "swedbank" },
    "review": { "id": 4211, "rating": 5, "title": "…", "invitation": { "id": 812, "reference": "10045" }, … }
  }
}

Paraksta pārbaude. v1 = HMAC-SHA256 ar tavu whsec_… noslēpumu no virknes {t}.{neapstrādātais ķermenis}. Noraidi pieprasījumus, kas vecāki par 5 minūtēm.

Node.js (Express)

import { createHmac, timingSafeEqual } from 'node:crypto';

app.post('/hooks/atsauksmes', express.raw({ type: 'application/json' }), (req, res) => {
  const parts = Object.fromEntries(req.get('GA-Signature').split(',').map((p) => p.split('=')));
  const expected = createHmac('sha256', process.env.GA_WEBHOOK_SECRET).update(parts.t + '.' + req.body).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  if (!fresh || !timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1))) return res.sendStatus(401);
  const event = JSON.parse(req.body);
  // event.data.review …
  res.sendStatus(204);
});

PHP

$body = file_get_contents('php://input');
parse_str(str_replace(',', '&', $_SERVER['HTTP_GA_SIGNATURE'] ?? ''), $sig);
$expected = hash_hmac('sha256', $sig['t'] . '.' . $body, GA_WEBHOOK_SECRET);
if (abs(time() - (int) $sig['t']) > 300 || !hash_equals($expected, $sig['v1'] ?? '')) {
    http_response_code(401); exit;
}
$event = json_decode($body, true);

Notikumi: review.created, test (poga «Nosūtīt testu»).

Receptes

WooCommerce — uzaicinājums, kad pasūtījums izpildīts

// functions.php vai neliels spraudnis
add_action('woocommerce_order_status_completed', function ($order_id) {
    $order = wc_get_order($order_id);
    wp_remote_post('https://godigasatsauksmes.lv/api/v1/invitations', [
        'headers' => [
            'Authorization' => 'Bearer ' . GA_API_KEY,
            'Content-Type'  => 'application/json',
        ],
        'body' => wp_json_encode([
            'email'      => $order->get_billing_email(),
            'name'       => $order->get_billing_first_name(),
            'reference'  => (string) $order_id,
            'delay_days' => 5,
        ]),
        'timeout' => 5,
    ]);
});

Shopify — Flow

Izveido Flow: trigeris Order fulfilled → darbība Send HTTP request: metode POST, URL https://godigasatsauksmes.lv/api/v1/invitations, galvenes Authorization: Bearer … un Content-Type: application/json, ķermenis:

{"email":"{{order.email}}","name":"{{order.customer.firstName}}","reference":"{{order.name}}","delay_days":5}

Saite pasūtījuma e-pastā (jebkura platforma)

Ja e-pastu sūti pats, izveido uzaicinājumu bez email — atbildē būs link, ko ievieto e-pastā («Novērtē mūs»). Vai izmanto parakstītu saiti bez API izsaukuma.

Make, Zapier, n8n

Izmanto HTTP moduli ar tiem pašiem parametriem kā curl piemērā. Jaunas atsauksmes uz Slack vai Google Sheets — ar webhook trigeri.

Noteikumi un limiti

API v1 · atjaunots 2026-11-19. Izmaiņas, kas var salauzt integrācijas, paziņosim vismaz 60 dienas iepriekš.