Dokumentace API – Hledání úřadů

Webová služba pro hledání úřadů je k dispozici na adrese:

  • https://secure.smartform.cz/smartform-ws/searchAuthority/v1

Služba využívá protokolu HTTP, dotazy musí být posílány metodou POST. Data komunikace mezi klientem a serverem jsou posílána ve formátu JSON s kódováním UTF-8.

Hlavička http requestu musí obsahovat následující položky:

názevhodnota
Content-typeapplication/json
Acceptapplication/json

Následuje referenční struktura dotazu a odpovědi. Objekty jsou zachyceny ve formě pseudokódu pro lepší pochopení struktury.

Dotaz

/** Dotaz pro službu searchAuthority */
class SearchAuthorityRequest 
{
    /** Identifikace dotazu, slouží jen pro spárování dotazu a odpovědi. */  
    int id;

    /** Heslo - pokud jej nemáte, získáte ho v administraci na https://secure.smartform.cz/admin */
    string password;

    /** Vstupní data. */
    Map<InputFieldTypeSearchAuthority, string> inputData;
}

Odpověď

/** Odpověď pro službu searchAuthority */
class SearchAuthorityResponse 
{
    /** Identifikace odpovědi, odpovídá id dotazu */
    int id;

    /** Zdali vůbec proběhlo hledání v pořádku */
    ResultCode resultCode;

    /** Pokud došlo k nějaké chybě, popisuje k jaké */
    string errorMessage;

    /** Typ úřadu */
    ResultTypeAuthority typeAuthority;
                            
    /** Informace o úřadu/ůřadech, které vychází z
     *  xml datových schránek.
     *  Konkrétní popis atributů v dokumentaci kapitola 2.1.4. 
     */
    List<AuthorityEntity> authority;
}

Další objekty

/** Typ vstupních dat */
enum InputFieldTypeSearchAuthority 
{
    /**  Kód adresy z registru RUIAN */
    RUIAN_CODE
}
/** Výsledný typ úřadu */
enum ResultTypeAuthority 
{
    /** Obecní úřad */
    LOCAL_AUTHORITY,
                            
    /** Jiný typ úřadu */
    OTHER_AUTHORITY,

    /** Na jedné adrese se nachází více úřadů */
    MANY_AUTHORITIES,
                    
    /** Vstupní adresa není úřadem */
    NO_AUTHORITY
}
/** Výsledek dotazu. */
enum ResultCode 
{
    /** Volání service proběhlo v pořádku. */
    OK,
    
    /** Při volání service došlo k chybě. */
    FAIL
}

Tabulka typů v pseudokódu

typ v pseudokódutyp v JSON
třída (class)vnořený objekt
výčet (enum)řetězec se jménem vybrané položky
Listpole
Mapobjekt – klíče a hodnoty se stanou položkami objektu
stringřetězec
intčíslo
doublečíslo
booleanboolean
char (jeden znak)řetězec


Hlavní navigace: