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