Események küldése a FindGore rendszerébe

Az eseményeket szoftveresen lehet küldeni a FindGore rendszerébe az API felületen keresztül.

Ehhez szükség van egy API kulcsra, illetve a FindGore API kapcsolathoz szükséges szoftveres környezetre.

Az események neve bármilyen karaktersorozat lehet, ami

• maximum 50 karakter
• a következő karaktereket tartalmazza
  • angol abc kis és nagy betűi
  • számok
  • aláhúzás ( _ ) vagy kötőjel ( - )

Az eseményeket nem kell előre felvenni a FindGore felületén, az első küldéskor ez automatikusan megtörténik a háttérben.

Fontos, hogy amennyiben az eseménnyel küldött UUID invalid, a FindGore API automatikusan eldobja a kérést, és erről nem küld hibaüzenetet.

Az eseményekkel együtt lehet bármilyen egyéb paramétert küldeni asszociatív tömb formájában. Ezeknek a paramétereknek a teljes mérete nem haladhatja meg az 500 byte-ot. A paraméterek a következő adat típusokat tartalmazhatják:

• logikai értékek
• egész számok
• valós számok
• karakterláncok
• tömbök
• asszociatív tömbök

Minden paraméter névnek és értéknek UTF-8 karakter kódolást kell használnia.

A paraméterekre jelenleg nem lehet külön keresni a FindGore rendszerében.

Az egyedi paraméterek nevei nem vehetik fel a következő értékeket, mivel ezeknek speciális jelentése van a rendszerben:

• email (ezzel a névvel kizárólag az uuid-hoz tartozó e-mail címet lehet küldeni)
• uuid (ez kizárólag a profil uuid-ja lehet, amit a sütik közé rak le a FindGore url tracker rendszere)
• score (ez a paraméter kizárólag a score modulnak szolgáltathat adatot)