API Dokumentáció

API Végpontok és Kérések

A QRasynk API lehetővé teszi QR kódok dinamikus generálását és kezelését. Az alábbiakban részletesen ismertetjük az elérhető végpontokat és a hozzájuk tartozó kérések paramétereit.

Alap URL

https://api.qrasynk.com/v1/

Végpontok

  • POST /qr/create - Új QR kód generálása
  • GET /qr/{id} - QR kód adatainak lekérdezése
  • PUT /qr/{id} - QR kód frissítése
  • DELETE /qr/{id} - QR kód törlése
  • GET /qr/list - Felhasználóhoz tartozó QR kódok listázása
API végpontok diagramja

Példakódok

Az alábbi példák segítenek a gyors integrációban különböző programozási nyelveken.

JavaScript (Fetch API)

fetch('https://api.qrasynk.com/v1/qr/create', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    content: 'https://qrasynk.com',
    size: 300,
    format: 'png'
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Python (Requests)

import requests

url = "https://api.qrasynk.com/v1/qr/create"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}
data = {
    "content": "https://qrasynk.com",
    "size": 300,
    "format": "png"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Gyakori Hibák és Megoldásaik

Ez a hiba akkor fordul elő, ha érvénytelen vagy hiányzó API kulccsal próbálsz hozzáférni a végponthoz. Ellenőrizd, hogy:

  • Az API kulcs helyesen van megadva
  • A kulcs nem járt le
  • A kérés fejlécében helyesen szerepel az Authorization mező

Ez a hiba általában hibás kérési paraméterek miatt fordul elő. Gyakori okok:

  • Hiányzó kötelező mezők
  • Érvénytelen formátumú adatok
  • Túl nagy vagy túl kicsi értékek

A hibaüzenet részleteiben mindig megtalálod, hogy pontosan melyik mezővel van probléma.

Ez a hiba akkor jelenik meg, ha túllépted az API hívások számára vonatkozó korlátot. Megoldások:

  • Csökkentsd az API hívások gyakoriságát
  • Vedd fel velünk a kapcsolatot a korlát növeléséért
  • Használj gyorsítótárazást a lokális oldalon

API Kulcsod Biztonsága

Az API kulcsod biztonsága kritikus fontosságú. Soha ne oszd meg nyilvánosan, és ne tedd verziókövetés alá a kódodban!

Jó gyakorlat:

Használj környezeti változókat vagy konfigurációs fájlokat, amelyeket a .gitignore kizár.

API Verziószámozás

Az API-nk verziószámozott, így biztosítva a visszafelé kompatibilitást. Jelenleg a v1 verziót használjuk.

Fontos: Mindig a legfrissebb dokumentációt használd, mivel az API folyamatosan fejlődik.

Támogatásra van szükséged?

Ha bármilyen kérdésed van az API használatával kapcsolatban, vagy technikai segítségre van szükséged, nyugodtan keress minket a Támogatás/FAQ oldalon.

API Használati Statisztikák

Kövesd az API hívásaid teljesítményét és használatát valós időben.

24.5k
API hívás / nap
99.2%
Uptime
28ms
Átlagos válaszidő
1.2k
Aktív fejlesztő

Statisztikai grafikon itt jelenne meg