Projekt

Obecné

Profil

Komunikační protokol » Historie » Verze 11

Ondřej Váně, 2020-05-06 15:37

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
** Query message:
21
<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>