Projekt

Obecné

Profil

Komunikační protokol » Historie » Verze 9

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

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
	"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>