QR-Referral-v1

A Barion wikiből
  • Tervezet
  • Üzlet
  • Informatika
  • Pénzügy
  • Jog
  • 99%
  • Online elfogadó
  • Mobil elfogadó
  • Pénztárgép
  • Feltöltés
  • Piactér
  • Nonprofit
  • Parkolas

QR kód generálása más felhasználók meghívásához

GET /QR/Referral

Ezen hívással a felhasználó előállíthat egy QR kódot, amelyet beolvasva a regisztrációs oldalra jut oly módon, hogy a meghívó felhasználó adatai automatikusan kitöltésre kerülnek és rejtve maradnak. Ezzel további felhasználók regisztrálhatnak a QR kódot előállító felhasználó alá. Ennek különböző nyereményjátékok, illetve akciók esetén van jelentősége.

Bemenet

Mező neve Mező típusa Kötelező Megkötések Alapértelmezett érték Leírás Formátum / Példa
R string Opcionális nincs nincs A felhasználó e-mail címe vagy feltöltőkódja. pistike@example.com

Kimenet

A kimenet minden hívás esetén hasonló felépítésű. Amennyiben sikeres hívás történt az ErrorList hibatömb üresen érkezik. Ha hiba történt, akkor a hibatömbben láthatóak ezek a hibák, de ilyen esetben is megkapjuk a többi kimeneti paramétert, csak üresen vagy pedig egy default alapértékkel.

Mező Típus Leírás Formátum / Példa
Image byte[] QR kód, amely egy olyan regisztrációs oldalra vezet, ahol a meghívó azonosítója ki van töltve a QR kódot generáló felhasználó meghívási azonosítójával. Amennyiben a hívásban az R paraméter üres volt, a QR kódban található URL a standard regisztrációs oldalra irányít.
Barionqr1.png
Megjegyzés: ennél az API hívásnál nem található Errorlist a kimenetben.

Hibalehetőségek

Ez az API hívás semmilyen esetben nem jelez hibát. Amennyiben az R bemenő paraméter üres, a generált QR kód egyszerűen a regisztrációs oldalra mutat. Amennyiben érvénytelen feltöltőkódot vagy e-mail címet adunk meg a generáláskor, azt az API ellenőrzés nélkül beépíti a QR kódba, de a rendszer a regisztrációs folyamat közben kiszűri az érvénytelen adatokat.

Példa

Az alábbi hívásban a felhasználó egy QR kódot generál saját feltöltőkódjával. A rendszer által előállított kód képe látható a hívás válaszában.

Bemenet

https://api.barion.com/QR/Referral?R=170003432

Kimenet

Barionqr1.png