Importní rozhraní manuál - Metody makléřů

Metody makléřů

addSeller ( session_id as string, seller_id as int, seller_rkid as string, client_data as struct )

Přidání nového makléře.

Aby makléř byl vložen, je potřeba vyplnit povinné položky v rámci struktury client_data.

struct client_data
{
	string client_login 		login pod kterým se případně bude makléř přihlašovat
	string client_name 		jméno makléře
	string contact_gsm 		mobil makléře
	string contact_phone 		nepovinný údaj, telefon
	string contact_email 		nepovinný údaj, kontaktní email se může lišit
	binary photo 			nepovinný údaj, obrázek makléře
	)
}

Pomocí seller_id nebo seller_rkid se identifikuje makléř (viz úvod). Při vkládaní inzerátu, pokud má vlastního makléře, je tedy na výběr mezi seller_rkid a seller_id. Ostatní položky ze struktury client_data jako contact_phone (telefon) a photo (fotografie makléře) jsou nepovinné. U korektně vloženého makléře je získáno seller_id číslo.

struct client_data
{
	int status 			Status (200=OK
					   	407=Neplatné přihlášení
						452=Nejsou vyplněny všechny povinné položky	
						    nebo jsou špatného typu
						461=Makléř neexistuje
						462=Login makléře je již použit
						476=Není to JPEG/GIF/PNG obrázek
					)
	string statusMessage 		Slovní popis statusu.
	array struct output
	(
		int seller_id 	Číslo makléře
	)
}

delSeller( session_id as string, seller_id as int, seller_rkid as string )

Odebrání existujícího makléře.

Odstranění proběhne při vyplněním seller_id nebo seller_rkid. Pomocí seller_id nebo seller_rkid se identifikuje makléř (viz úvod).

struct
{
	int status 			Status (200=OK
					   	402=Neexistujici klient
						452=Nejsou vyplněny všechny povinné položky	
						407=Neplatne prihlaseni
						461=Makléř neexistuje
					)
	string statusMessage 		Slovni popis statusu.
	array struct output
	(
	)
}

listSeller( session_id as string )

Výpis makléřů.

V output je vráceno pole, kde každý prvek pole obsahuje strukturu (viz níže). Makléři jsou seřazeny podle pořadí vložení.

struct
{
	int status 			Status (200=OK
						407=Neplatne prihlaseni
					)
	string statusMessage 		Slovní popis statusu.
	array struct output
	(
		int seller_id 		Číslo makléře
		string seller_rkid 	Interní čislo rk makléře
		string client_name 	Jméno a přijmení
		string client_login 	Login (email) makléře
		int photo 		Fotografie 1-ano, 0-ne
	)
}