Recept

Minimum QUiCK API integráció építése

Nulláról egy működő integrációt szeretnél összerakni: kulcs, első kérés, első válasz.

Kezdő~20 perc4 lépés

Előfeltételek

Aktív QUiCK fiók
API kulcs a Fejlesztői felületen kigenerálva
cURL vagy Node.js 18+ elérhető

1. API kulcs kigenerálása

Jelentkezz be a QUiCK adminba, majd Beállítások → Fejlesztői kulcsok menüben hozz létre egy új kulcsot. Másold ki azonnal — a titkos részt később már nem tudod visszanézni.

A kulcsot környezeti változóban tárold, sose commitold a repóba.

2. Első health-check hívás

Egy GET /v1/ping hívással ellenőrzöd, hogy a kulcs érvényes és a hálózati útvonal működik.

bash

curl -sS https://api.quick.es/v1/ping \
  -H "Authorization: Bearer $QUICK_API_KEY"

Sikeres válasz:

json

{ "status": "ok", "tenant": "acme-kft" }

3. Első üzleti hívás — cég adatai

Húzd le a saját tenantod adatait, hogy lásd, a hitelesítés a Data API-n is átmegy.

bash

curl -sS https://api.quick.es/v1/company \
  -H "Authorization: Bearer $QUICK_API_KEY"

4. Node.js kliens vázlat

import { fetch } from "undici";

const BASE = "https://api.quick.es/v1";
const KEY = process.env.QUICK_API_KEY!;

export async function quickFetch(path: string, init: RequestInit = {}) {
  const res = await fetch(`${BASE}${path}`, {
    ...init,
    headers: {
      ...init.headers,
      "Authorization": `Bearer ${KEY}`,
      "Content-Type": "application/json",
    },
  });
  if (!res.ok) throw new Error(`QUiCK ${res.status}: ${await res.text()}`);
  return res.json();
}

Kapcsolódó endpointok

GET/v1/ping
GET/v1/company

Kapcsolódó fogalmak

api_key tenant

Gyakori hibák

A kulcs a frontendbe kerül

A QUiCK API kulcsok szerver-oldali titkok. Ha böngészőből hívnád, egy proxyt tegyél elé, ami a saját sessionje alapján adja hozzá a Authorization fejlécet.

Base URL elhagyása környezetenként

Sandbox és production különböző base URL-en válaszol. Vezesd be QUICK_API_BASE env változóként az első naptól.