GARAN API – napojenie e-shopu alebo služby

Ako začať

1. 1
   Balík Business alebo Scale

   Vlastné API napojenie je v balíkoch Business (1 000 označení mesačne) a Scale (5 000). Označenia z API sa počítajú do toho istého limitu ako v generátore.

2. 2
   Vygenerujte API kľúč

   V účte otvorte Prepojenie e-shopu, pomenujte kľúč (napr. podľa domény) a uložte si ho – zobrazí sa len raz. Na účet je možných až 10 kľúčov, každý sa dá samostatne zrušiť.

3. 3
   Posielajte kľúč v hlavičke

   Každé volanie obsahuje hlavičku Authorization: Bearer garan_…. Kľúč používajte len na serveri, nikdy v prehliadači ani v mobilnej aplikácii.

4. 4
   Vytvorte prvé označenie

   Jedno volanie POST /api/labels so značkou, modelom a rokmi vráti hotové SVG farebného aj vnoreného označenia.

Základné údaje

GET /api/me – stav účtu

Vráti balík, využitie a to, či má účet vlastné API napojenie. Vhodné na overenie kľúča a zobrazenie zostávajúceho limitu vo vašom systéme.

curl -H "Authorization: Bearer garan_VÁŠ_KĽÚČ" \
  "https://garangenerator.sk/wp-json/garan/v1/api/me?shop=mojeshop.sk"

{
  "account": { "email": "firma@example.sk", "name": "Firma" },
  "plan": { "slug": "business", "name": "Business", "limit": 1000,
            "formats": ["png","jpg","svg","pdf","webp"],
            "period_end": "2026-10-27 09:00:00", "api": true },
  "usage": { "used": 124, "limit": 1000, "remaining": 876 }
}

Parameter shop je nepovinný – doména sa zobrazí v účte pri kľúči, aby ste vedeli, ktorý systém ho používa.

POST /api/labels – vytvorenie označenia

curl -X POST "https://garangenerator.sk/wp-json/garan/v1/api/labels" \
  -H "Authorization: Bearer garan_VÁŠ_KĽÚČ" \
  -H "Content-Type: application/json" \
  -d '{"brand":"Kärcher","model":"WD 3 P","years":"5","embed_fonts":true}'

{
  "id": 1284,
  "brand": "Kärcher", "model": "WD 3 P", "years": "5",
  "years_label": "5 rokov",
  "duplicate": false,
  "svg": { "colour": "<svg …>", "nested": "<svg …>" },
  "link_url": "https://europa.eu/youreurope/commercial-guarantee-durability/index.htm",
  "usage": { "used": 125, "limit": 1000, "remaining": 875 }
}

GET /api/notice – oznámenie o zákonnej záruke

Vráti adresy oficiálnych slovenských súborov harmonizovaného oznámenia (PDF, PNG, SVG), adresu obrázka a cieľ odkazu. Oznámenie sa neupravuje – stačí ho zobraziť a prelinkovať.

curl -H "Authorization: Bearer garan_VÁŠ_KĽÚČ" "https://garangenerator.sk/wp-json/garan/v1/api/notice"

Príklady

PHP

$response = wp_remote_post( 'https://garangenerator.sk/wp-json/garan/v1/api/labels', array(
    'headers' => array(
        'Authorization' => 'Bearer ' . GARAN_API_KEY,
        'Content-Type'  => 'application/json',
    ),
    'body'    => wp_json_encode( array(
        'brand' => 'Kärcher',
        'model' => 'WD 3 P',
        'years' => '5',
    ) ),
    'timeout' => 20,
) );

$data = json_decode( wp_remote_retrieve_body( $response ), true );
$svg  = $data['svg']['colour'] ?? '';

JavaScript (Node.js, na serveri)

const res = await fetch('https://garangenerator.sk/wp-json/garan/v1/api/labels', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.GARAN_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ brand: 'Kärcher', model: 'WD 3 P', years: '5', embed_fonts: true }),
});

const { svg, link_url } = await res.json();

Zobrazenie v e-shope

SVG vložte do stránky produktu a pri označení zobrazte klikateľný odkaz z poľa link_url. Ak používate SVG bez vloženého písma, načítajte na stránke písmo Inter (rezy Regular a ExtraBold). Pravidlá online zobrazenia sú v návode Ako zobrazovať GARAN označenie v e-shope.

Chybové odpovede

Každá chyba má tvar {"code": "…", "message": "…", "data": {"status": 403}}. Text v message je po slovensky a dá sa zobraziť správcovi e-shopu.

Bezpečnosť a odporúčania