Dbrain
Search…
Асинхронный режим
По умолчанию Dbrain работает в синхронном режиме. Вы отправляете файл на классификацию или распознавание, дожидаетесь получения ответа и только после этого отправляете следующий файл. Такой режим удобен при малом потоке документов и в тестовых целях. В остальных случаях мы рекомендуем использовать асинхронный режим. Чтобы включить его, в параметрах запроса укажите async=true.
1
# асинхронный запрос распознавания паспорта из файла passport.jpg, облачная версия:
2
$ curl -X POST \
3
"https://latest.dbrain.io/recognize?doc_type=passport_main&quality=75&dpi=300&auto_pdf_raw_images=true&pdf_raw_images=true&async=true&token=ваш_ключ_лицензии" \
4
-H "accept: application/json" \
5
-H "Content-Type: multipart/form-data" \
6
-F "[email protected];type=image/jpeg"
Copied!
В ответ на асинхронный запрос Dbrain вернёт такой HTTP-заголовок:
1
access-control-allow-credentials: true
2
access-control-allow-origin: https://latest.dbrain.io
3
content-length: 130
4
content-type: application/json
5
date: Tue08 Sep 2020 11:47:52 GMT
6
server: nginx/1.15.2
7
status: 200
Copied!
Структура тела HTTP-сообщения следующая:
1
{
2
"detail": [],
3
"items": [],
4
"task_id": "5f576f68a3c2c6b689ff7a83",
5
"code": null,
6
"message": null,
7
"errno": null,
8
"traceback": null,
9
"fake": null
10
}
Copied!
task_id необходимо указать для получения результатов распознавания или классификации, например:
1
# в параметре token укажите ваш ключ лицензии
2
$ curl -si \
3
"https://latest.dbrain.io/result/5f576f68a3c2c6b689ff7a83?token=xxx"
Copied!

Возможные варианты ответов на запрос результатов

Выполнено
Не выполнено
Не найдено
Еслиtask_idнайден, а классификация или распознавание завершены, код ответа — 200.
HTTP-заголовок:
1
content-encoding: gzip
2
content-length: 896
3
content-type: application/json
4
date: Tue08 Sep 2020 11:26:22 GMT
5
server: nginx/1.15.2
6
status: 200
7
vary: Accept-Encoding
Copied!
Тело сообщения на примере распознавания паспорта:
1
{
2
"detail": [],
3
"items": [
4
{
5
"doc_type": "passport_main",
6
"fields": {
7
"date_of_birth": {
8
"text": "",
9
"confidence": 0,
10
"valid": null,
11
"coords": [
12
[
13
[
14
880,
15
1446
16
],
17
[
18
1187,
19
1446
20
],
21
[
22
1187,
23
1497
24
],
25
[
26
880,
27
1497
28
]
29
]
30
]
31
},
32
"date_of_issue": {
33
"text": "17.12.2004",
34
"confidence": 0.7422276735305786,
35
"valid": null,
36
"coords": [
37
[
38
[
39
233,
40
422
41
],
42
[
43
537,
44
419
45
],
46
[
47
537,
48
473
49
],
50
[
51
233,
52
476
53
]
54
]
55
]
56
},
57
"first_name": {
58
"text": "ЕВГЕНИЙ",
59
"confidence": 0.998583197593689,
60
"valid": null,
61
"coords": [
62
[
63
[
64
748,
65
1289
66
],
67
[
68
972,
69
1289
70
],
71
[
72
972,
73
1340
74
],
75
[
76
748,
77
1340
78
]
79
]
80
]
81
},
82
"issuing_authority": {
83
"text": "ОТДЕЛОМ ВНУТРЕННИХ ДЕЛ ОКТЯБРЬСКОГО ОКРУГА ГОРОДА АРХАНГЕЛЬСКА",
84
"confidence": 0.995008111000061,
85
"valid": null,
86
"coords": [
87
[
88
[
89
441,
90
208
91
],
92
[
93
646,
94
201
95
],
96
[
97
646,
98
240
99
],
100
[
101
441,
102
246
103
]
104
],
105
[
106
[
107
681,
108
201
109
],
110
[
111
976,
112
201
113
],
114
[
115
976,
116
236
117
],
118
[
119
681,
120
236
121
]
122
],
123
[
124
[
125
1011,
126
201
127
],
128
[
129
1097,
130
201
131
],
132
[
133
1097,
134
236
135
],
136
[
137
1011,
138
236
139
]
140
],
141
[
142
[
143
502,
144
278
145
],
146
[
147
857,
148
278
149
],
150
[
151
857,
152
313
153
],
154
[
155
502,
156
313
157
]
158
],
159
[
160
[
161
889,
162
275
163
],
164
[
165
1065,
166
275
167
],
168
[
169
1065,
170
307
171
],
172
[
173
889,
174
307
175
]
176
],
177
[
178
[
179
502,
180
355
181
],
182
[
183
678,
184
355
185
],
186
[
187
678,
188
390
189
],
190
[
191
502,
192
390
193
]
194
],
195
[
196
[
197
713,
198
352
199
],
200
[
201
1065,
202
348
203
],
204
[
205
1065,
206
384
207
],
208
[
209
713,
210
387
211
]
212
]
213
]
214
},
215
"other_names": {
216
"text": "АЛЕКСАНДРОВИЧ",
217
"confidence": 0.9980864524841309,
218
"valid": null,
219
"coords": [
220
[
221
[
222
659,
223
1366
224
],
225
[
226
1065,
227
1366
228
],
229
[
230
1065,
231
1417
232
],
233
[
234
659,
235
1417
236
]
237
]
238
]
239
},
240
"place_of_birth": {
241
"text": "ГОР. АРХАНГЕЛЬСК",
242
"confidence": 0.9998399019241333,
243
"valid": null,
244
"coords": [
245
[
246
[
247
643,
248
1536
249
],
250
[
251
745,
252
1536
253
],
254
[
255
745,
256
1568
257
],
258
[
259
643,
260
1568
261
]
262
],
263
[
264
[
265
790,
266
1536
267
],
268
[
269
1110,
270
1536
271
],
272
[
273
1110,
274
1568
275
],
276
[
277
790,
278
1568
279
]
280
]
281
]
282
},
283
"sex": {
284
"text": "МУЖ.",
285
"confidence": 0.9768308401107788,
286
"valid": null,
287
"coords": [
288
[
289
[
290
540,
291
1449
292
],
293
[
294
665,
295
1449
296
],
297
[
298
665,
299
1500
300
],
301
[
302
540,
303
1500
304
]
305
]
306
]
307
},
308
"subdivision_code": {
309
"text": "292-000",
310
"confidence": 0.9457029104232788,
311
"valid": null,
312
"coords": [
313
[
314
[
315
825,
316
416
317
],
318
[
319
1052,
320
416
321
],
322
[
323
1052,
324
464
325
],
326
[
327
825,
328
464
329
]
330
]
331
]
332
},
333
"surname": {
334
"text": "ИМЯРЕК",
335
"confidence": 0.9971189498901367,
336
"valid": null,
337
"coords": [
338
[
339
[
340
742,
341
1132
342
],
343
[
344
944,
345
1132
346
],
347
[
348
944,
349
1184
350
],
351
[
352
742,
353
1184
354
]
355
]
356
]
357
},
358
"series_and_number": {
359
"text": "1104 000000",
360
"confidence": 0.9674372673034668,
361
"valid": null,
362
"coords": null
363
}
364
},
365
"color": true,
366
"error": null
367
}
368
],
369
"task_id": null,
370
"code": null,
371
"message": null,
372
"errno": null,
373
"traceback": null,
374
"fake": null
375
}
Copied!
Еслиtask_idнайден, но классификация или распознавание документа ещё не завершены, код ответа — 202. Сделайте повторный запрос через некоторое время.
HTTP-заголовок:
1
content-length: 162
2
content-type: application/json
3
date: Tue08 Sep 2020 12:05:32 GMT
4
server: nginx/1.15.2
5
status: 202
Copied!
Тело сообщения:
1
{
2
"detail": [
3
{
4
"msg": "Async task not done",
5
"type": "result_error"
6
}
7
],
8
"items": null,
9
"task_id": null,
10
"code": 202,
11
"message": "Async task not done",
12
"errno": 9,
13
"traceback": null
14
}
Copied!
Еслиtask_id не найден, код ответа — 404. Проверьте, что запрашиваете правильныйtask_id.
HTTP-заголовок:
1
content-length: 164
2
content-type: application/json
3
date: Tue08 Sep 2020 12:03:22 GMT
4
server: nginx/1.15.2
5
status: 404
Copied!
Тело сообщения:
1
{
2
"detail": [
3
{
4
"msg": "Async task not found",
5
"type": "result_error"
6
}
7
],
8
"items": null,
9
"task_id": null,
10
"code": 404,
11
"message": "Async task not found",
12
"errno": 8,
13
"traceback": null
14
}
Copied!