Komunikační protokol » Historie » Verze 8
Ondřej Váně, 2020-05-06 15:25
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 | * */documents*: GET => vypsání všech dokumetů (název, datum, atd.) jen základní info |
||
15 | 8 | Ondřej Váně | * */documents/{název dokumentu}*: GET => vypsání všech dokumetů (název, datum, atd.) jen základní info |
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 | ** Query message: |
||
21 | <pre><code class="json"> |
||
22 | { |
||
23 | "query": "hledaný výraz", |
||
24 | "date": "čas odeslání dotazu" |
||
25 | |||
26 | } |
||
27 | </code></pre> |
||
28 | ** Query to Solr message: |
||
29 | <pre><code class="json"> |
||
30 | { |
||
31 | "query": "Pole pro vyhledávání : hledaný výraz" |
||
32 | |||
33 | } |
||
34 | </code></pre> |
||
35 | ** Query result from Solr: |
||
36 | <pre><code class="json"> |
||
37 | { |
||
38 | "IdDocument":"id dokumentu", |
||
39 | "TextRegion":{ |
||
40 | "PlainText":"text region", |
||
41 | "Coords":"koordináty regionu", |
||
42 | "TextLine":[ |
||
43 | { |
||
44 | "PlainText":"text line", |
||
45 | "Coords":"koordináty řádky", |
||
46 | "TextWord":[ |
||
47 | { |
||
48 | "PlainText":"text word", |
||
49 | "Coords":"koordináty slova" |
||
50 | } |
||
51 | ] |
||
52 | } |
||
53 | ] |
||
54 | } |
||
55 | } |
||
56 | </code></pre> |
||
57 | |||
58 | ** Query response: |
||
59 | <pre><code class="json"> |
||
60 | { |
||
61 | "IdDocument":"id dokumentu", |
||
62 | "DocumentImage":"Obrázek v Base64", |
||
63 | "TextRegion":{ |
||
64 | "PlainText":"text region", |
||
65 | "Coords":"koordináty regionu", |
||
66 | "TextLine":[ |
||
67 | { |
||
68 | "PlainText":"text line 1", |
||
69 | "Coords":"koordináty řádky", |
||
70 | "TextWord":[ |
||
71 | { |
||
72 | "PlainText":"text word 1", |
||
73 | "Coords":"koordináty slova" |
||
74 | } |
||
75 | ] |
||
76 | } |
||
77 | ] |
||
78 | } |
||
79 | } |
||
80 | </code></pre> |