Komunikační protokol » Historie » Verze 12
Ondřej Váně, 2020-05-06 15:38
1 | 2 | Zdeněk Častorál | h1. Komunikační protokol (v.1) |
---|---|---|---|
2 | |||
3 | * Jednotlivé zprávy budou zasílány ve fromátu JSON |
||
4 | * Komunikace bude probíhat pomocí HTTP protokolu |
||
5 | 7 | Ondřej Váně | * Budou využívány návratové HTTP kódy stavů (200, 400, 500, atd.) |
6 | 2 | Zdeněk Častorál | * Návrh komunikace na obrázku níže. |
7 | |||
8 | 6 | Ondřej Váně | !kom_protokol.png! |
9 | |||
10 | 2 | Zdeněk Častorál | h2. REST API - URL |
11 | |||
12 | 5 | Zdeněk Častorál | * */search*: POST => hledání výrazu v dokumentech |
13 | 2 | Zdeněk Častorál | * */documents*: POST => přídání nového dokumentu a obrázku |
14 | 9 | Ondřej Váně | * */documents*: GET => vypsání všech dokumemtů (název, datum, atd.) jen základní info |
15 | * */documents/{název dokumentu}*: GET => získání obrázku k danému dokumentu |
||
16 | 1 | Zdeněk Častorál | |
17 | 6 | Ondřej Váně | |
18 | 2 | Zdeněk Častorál | |
19 | * Struktura jednotlivých zpráv |
||
20 | 12 | Ondřej Váně | ** Query message: /search : POST |
21 | 2 | Zdeněk Častorál | <pre><code class="json"> |
22 | { |
||
23 | "query": "hledaný výraz", |
||
24 | 11 | Ondřej Váně | "date": "čas odeslání dotazu" |
25 | "enableSpellCheck": "logická hodnota, která určuje, zda se používá spell check" |
||
26 | 2 | Zdeněk Častorál | |
27 | } |
||
28 | </code></pre> |
||
29 | ** Query result from Solr: |
||
30 | <pre><code class="json"> |
||
31 | { |
||
32 | "IdDocument":"id dokumentu", |
||
33 | "TextRegion":{ |
||
34 | "PlainText":"text region", |
||
35 | "Coords":"koordináty regionu", |
||
36 | "TextLine":[ |
||
37 | { |
||
38 | "PlainText":"text line", |
||
39 | "Coords":"koordináty řádky", |
||
40 | "TextWord":[ |
||
41 | { |
||
42 | "PlainText":"text word", |
||
43 | "Coords":"koordináty slova" |
||
44 | } |
||
45 | ] |
||
46 | } |
||
47 | ] |
||
48 | } |
||
49 | } |
||
50 | </code></pre> |
||
51 | |||
52 | ** Query response: |
||
53 | <pre><code class="json"> |
||
54 | { |
||
55 | "IdDocument":"id dokumentu", |
||
56 | "DocumentImage":"Obrázek v Base64", |
||
57 | "TextRegion":{ |
||
58 | "PlainText":"text region", |
||
59 | "Coords":"koordináty regionu", |
||
60 | "TextLine":[ |
||
61 | { |
||
62 | "PlainText":"text line 1", |
||
63 | "Coords":"koordináty řádky", |
||
64 | "TextWord":[ |
||
65 | { |
||
66 | "PlainText":"text word 1", |
||
67 | "Coords":"koordináty slova" |
||
68 | } |
||
69 | ] |
||
70 | } |
||
71 | ] |
||
72 | } |
||
73 | } |
||
74 | </code></pre> |