Esemény kezelése | Sportnaptár Dokumentáció

Eseményeket az alábbi URL-en hozhatunk létre:

plaintext

https://sportnaptar.hu/event/create?api_key={Your Access Key}

Egy már meglevő eseményt az alábbi URL-en módosíthatunk az esemény IDját GET paraméterben megadva

plaintext

https://sportnaptar.hu/event/update?api_key={Your Access Key}&id={esemény IDja}

Az esemény törzs adatait Event paraméterként ($_POST[Event]) kell beküldeni, amik az alábbiak lehetnek:

a * mezők kötelezőek

neve	típusa	leírása
name*	string	neve max 200 karakter
status	int	állapota 0 => piszkozat, 1 => közzétett
description	string	rövid leírása max 500 karakter
postponed	int	el lett-e halasztva ha 0 akkor nincs ha 1 akkor igen, de még nincs meg az időpont, hogy mire lett elhalasztva >1 akkor az a dátum (timestamp) amiről el lett halasztva
is_instant	int	ez egy INSTANT esemény ha 0 akkor nem ha 1 akkor igen
links	array	a linkek között 2 fix van, a "website" és a "facebook" link, amik megjelenítéskor külön ikont kapnak

A linkek tömbjének az alábbiképp néz ki

json

"links": [
   "website": {"url": ""}
   "facebook": {"url" : ""},
   "0": {"name": "link neve" "url" : ""},
   ... további linkek 
]

Az esemény tevékenységei

Az eseményhez kötelező legalább 1 tevékenységet is beküldeni. A tevékenységeket "Activities"-ként kell küldeni ($_POST[Activities]), aminek egy tömbnek kell lennie.

A tevékenység az alábbi property-ket tartalmazza:

neve	típusa	leírása
id	int	ha van megadva ID, akkor egy már korábban beküldött tevékenység módosítható
name*	string	a tevékenység elnevezése, maximum 200 karakter
category_id*	int	a sportág azonosítója a sportágak listájának lekérését itt találod
type	int	esemény jellege a sportágon belül a jellegeket szintén a sportágak lekérése tartalmazza
unit_type	int	mértékegység 0 => SI 1 => Angolszász
distance	float	távolság a fentebbi mértékegységben
level	float	szintkülönbség a fentebbi mértékegységben
level_time	int	szintidő másodpercben
start_address	string	rajt helye/címe maximum 250 karakter
start_address_lat	float	a rajt szélességi foka formátuma: /^\d{1,2}\.\d{8}$/
start_address_lng	float	a rajt hosszúsági foka formátuma: /^\d{1,2}\.\d{8}$/
end_address	string	cél helye/címe maximum 250 karakter
end_address_lat	float	a cél szélességi foka formátuma: /^\d{1,2}\.\d{8}$/
end_address_lng	float	a cél hosszúsági foka formátuma: /^\d{1,2}\.\d{8}$/
start_date	timestamp	rajt időpontja
start_enddate	timestamp	rajt végének időpontja
end_date	timestamp	tevékenység vége
track_link	string	útvonal linkje maximum 255 karakter
description	string	rövid leírása maximum 2000 karakter
sort_order	int	a tevékenység sorrendje az eseményen belül (listázáskor)

Tevékenység törlése

A sportesemény tevékenysége 2 féleképp törölhető. Vagy a fentebbi tömb helyett csak a tevékenység ID-ját adjuk meg és egy Delete => 1 elemet, vagy az alábbi URL-en:

plaintext

https://sportnaptar.hu/event/deleteactivity?api_key={Your Access Key}&id={esemény IDja}&activityId={tevékenység azonosító}

Ha URL-en keresztül töröljük, és a sporteseménynek nem marad több tevékenysége, akkor a sportesemény is törlésere kerül.

Borítókép feltöltése

A sportesemény borítóképét az alábbi URL-en keresztül tölthetjük fel:

plaintext

https://sportnaptar.hu/event/setcover?api_key={Your Access Key}&id={esemény IDja}

A borítókép az alábbi kiterjesztésű lehet: jpg, jpeg, webp és png. A borítóképet 3 méretben kell küldeni base64-be kódolva.
Méretek:

large: 1280x512px
medium: 400x160px
small: 160x160px

példa:

json

$_POST = {
    "large": "data:image/jpeg;base64,...",
    "medium": "data:image/jpeg;base64,...",
    "small": "data:image/jpeg;base64,...",
}

A borítóképet az alábbi URL-en keresztül törölhetjük:

plaintext

https://sportnaptar.hu/event/removecover?api_key={Your Access Key}&id={esemény IDja}

Dokumentum csatolása

Dokumentumok csatolhatók az eseményhez, amik lehetnek pdf, gpx, jpg, jpeg fájlok, maximum mérete 5MB.
A fájlokat egyesével kell beküldeni base64-ben kódolva az alábbi URL-re:

plaintext

https://sportnaptar.hu/event/dokument?api_key={Your Access Key}&id={esemény IDja}

Dokumentum törlése

Vagy a fentebbi URL címre $_POST[Delete] -ként beküldjük a törlendő dokumentum fájlnevét, vagy az esemény összes dokumentuma egyszerre törölhető a $_POST[DeleteAll] -lal.

További leírások

A sporteseményhez leírásokat adhatunk, amihez az alábbi URL-re $_POST[Description] -ként kell beküldeni az adatot.

plaintext

https://sportnaptar.hu/event/description?api_key={Your Access Key}&id={esemény IDja}

Küldendő adat

neve	típusa	leírása
id	int	módisítás esetén a módosítandó leírás azonosítója
name*	string	leírás megnevezése, maximum 250 karakter
content	string	leírás tartalma, maximum 65 000 karakter és tartalmazhat HTML-t

Törléshez ugyan erre az URL kell beküldeni a leírás ID-ját és Delete => 1 paramétert, példa:

json

"Description": {
    "id": 10,
    "Delete": 1
}

Esemény törlése

Már meglévő esemény törléséhez az alábbi URL-t kell meghívni

plaintext

https://sportnaptar.hu/event/delete?api_key={Your Access Key}&id={törlendő esemény IDja}

előzőEsemény lekérése

következőSportágak