Aukro WebAPI
Včera jsem si při brouzdání po Aukro.cz aukcích všiml, že poskytují také své API. Rozhodl jsem se ho tedy trošku prozkoumat.
Dověděl jsem se, že Aukro poskytuje dvě verze svého API:
- zdarma
- placenou
Tyto dvě verze se od sebe liší počtem zpřístupněných funkcí (jelikož nehodlám nějak profesionálně využívat toto API, nemám prozkoumány funkce, které jsou pouze v placené verzi).
API využívá WSDL definice protokolu SOAP. Než je však možné API začít používat, je třeba splnit několik požadavků:
- mít účet na Aukro.cz
- požádat o klíč
V emailu ti následně přijde aktivační klíč a základní popis služby. Teď už jen stačí prostudovat si dokumentaci a začít API používat.
Uvedu jeden příklad napsaný v PHP:
$soap = new SoapClient('http://webapi.aukro.cz/uploader.php?wsdl');
public function doQuerySysStatus()
{
$params = array('sysvar' => 1, // na kterou funkci se ptáme
'country-id' => 56, // id země (56 pro ČR)
'webapi-key' => 'WEBAPIKEY'); // tvůj WebAPI klíč
return $this->soap->__soapCall('doQuerySysStatus', $params);
}
Jedná se o příklad "vytržený" ze samostatné třídy, takže tak jak je nebude fungovat. Takto zavolaná funkce vrátí následující pole:
array(2)
{
['info'] => strint(5) '1.0.1' // verze komponenty
['ver-key'] => int(97285726) // klic pro pouziti ve funkci doLogin
}
Informace v tomto výsledku, která se může a s největší pravděpodobností bude lišit od tvé, se dále využívá pro uskutečnění přihlášení uživatele do systému.
Použití AukroAPI není nijak složité a v podstatě jde pouze o volání požadované funkce se správnými parametry.
Napsal jsem velmi jednoduchou knihovnu umožňující přihlášení uživatele, načtení jeho aukcí, zobrazení stránky O mě, atd. Tu si můžeš stáhnout zde. Knihovna je volně ke stažení a lze ji libovolně modifikovat, pouze prosím o zachování autora, tedy mě.
