wiki:DebWriteApi
close Warning: Can't synchronize with repository "(default)" (/usr/local/svn/deb2-client does not appear to be a Subversion repository.). Look in the Trac log for more information.

Version 21 (modified by Adam, 8 years ago) (diff)

--

Server URL: https://abulafia.fi.muni.cz:9050

Administrace

URL + /admin

Funguje GET i POST stejně. Ke všem funkcím se dá přidat parametr callback s názvem funkce pro JSONP.

seznam přístupných slovníků

request

action
dict_list

response

JSON hash, který obsahuje status=OK a čtyři pole dict_a (slovníky, u kterých jsem administrátor), dict_m (slovníky, kde jsem správce), dict_w (slovníky, kam můžu zapisovat), dict_r (slovníky, které můžu číst). Každý slovník je objek, který obsahuje name (jméno slovníku) a code (kód slovníku, používá se u dalších funkcí)

Akce podle práv:

  • r/čtení: browse dictionary; export XML
  • w/zápis: browse+edit dictionary (stejný odkaz jako browse); export XML
  • m/správce: edit settings; remove dictionary; browse+edit dictionary; export XML; import XML
  • a/admin: edit settings; remove dictionary; browse+edit dictionary; export XML; import XML

informace o slovníku

request

action
dict_info
code
kód slovníku

response

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK
  • dict_code: kód slovníku
  • dict_name: jméno slovníku
  • schema: nastavení obsahu formuláře (JSON jako string)
  • users: pole se seznamem uživatelů (každý uživatel je hash s položkami, email, login, name, perm)
  • owner: uživatel, který slovník založil
  • templates: pole XSLT templates (každá položka má name, code, template)
  • htemplates: pole Handlebar templates (každá položka má name, code, template)
  • current_user: login přihlášeného uživatele
  • current_perm: právo přihlášeného uživatele ke slovníku

uložení nastavení slovníku

request

action
dict_save
edit
prázdné pro nový slovník, 1 pro editaci existujícího
dict_code
kód slovníku (Pokud je nový slovník, doplní se ke kódu login uživatele. Pro existující slovník se posílá kompletní kód včetně loginu)
dict_name
jméno slovníku
setting
JSON string s nastavením slovníku

response

Pro nový slovník se kontroluje, jestli už dict_code není obsazený. Při uložení existujícího se kontroluje, jesti má uživatel právo m.

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK
  • dict_code: kód slovníku

smazat slovník

request

action
dict_del
code
kód slovníku

response

Když uživatel nemá právo smazat slovník, zobrazí se chyba.

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK
  • dict_code: kód slovníku

najít uživatele

request

action
user_search
search
hledaný řetězec, delší než 2 znaky

response

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK
  • users: pole objektů s (name, email, login)

přidat uživatele ke slovníku

request

action
user_add
code
kód slovníku
login
login uživatele
perm
oprávnění, možné hodnoty r (read), w (write), m (manager). Pokud není vyplněno, default hodnota r

response

Kontroluje se, jestli existuje login, a jestli má přihlášený uživatel právo m na slovník.

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK

odebrat uživatele ze slovníku

request

action
user_remove
code
kód slovníku
login
login uživatele

response

Kontroluje se, jestli existuje login, a jestli má přihlášený uživatel právo m na slovník.

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK

přidat XSLT template ke slovníku

request

action
template_save
dict
kód slovníku
code
kód šablony
name
jméno šablony
template
obsah šablony

response

Kontroluje se, jestli má přihlášený uživatel právo m na slovník.

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK

odebrat XSLT template ke slovníku

request

action
template_remove
dict
kód slovníku
code
kód šablony

response

Kontroluje se, jestli má přihlášený uživatel právo m na slovník.

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK

přidat Handlebars template ke slovníku

request

action
htemplate_save
dict
kód slovníku
code
kód šablony
name
jméno šablony
template
obsah šablony

response

Kontroluje se, jestli má přihlášený uživatel právo m na slovník.

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK

odebrat Handlebars template ke slovníku

request

action
htemplate_remove
dict
kód slovníku
code
kód šablony

response

Kontroluje se, jestli má přihlášený uživatel právo m na slovník.

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK

Uživatelská část

URL + /kód slovníku

seznam hesel + hledání

request

action
list
search
hledaný text (nepovinné)

response

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK
  • entries: pole objektů (id, head, pro správce navíc author, last_edit)

načtení hesla

request

action
get
entry_id
ID hesla
format
xml (default), json, template
xslt
pro format=template kód template

response

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK
  • result: obsah hesla podle formatu

uložení hesla

request

action
save
entry_id
ID hesla
data
heslo v XML

response

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK

smazání hesla

request

action

response

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK

upload souboru

request

action

response

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK

náhled více hesel najednou

request

action

response

chyba JSON hash:

  • status: error
  • text: řetězec, text chyby

úspěch JSON hash:

  • status: OK