readings/<id>.json: the app's on-device reading of one original (OCR pages, blocks, lines, optional words, normalized regions and confidences) and the reader's result JSON. Text limits are UTF-8 bytes: page 262144, block 65536, line 8192, word 2048. Page indexes are unique. Together with the paper record it must fit the apps' analysis store (50,000 nodes, 2 MiB). sdkAnalysis is ShowPapers-internal: copy it unchanged or set it to null; never edit it.
Top Level
| Member | Type | Rules |
|---|
readingVersion required | 1 | |
extractorVersion required | integer | min 1; max 100000 |
concerns required | array of one of "no-text", "unrecognized-document", "conflicting-document-types", "no-supported-fields", "field-limit-reached" | max items 5; unique |
pages required | array of page | max items 200 |
sdkAnalysis required | null or object | |
Definitions
unit
number · min 0; max 1
region
Normalized to the rendered page (0..1). box is [left, top, right, bottom] with left <= right and top <= bottom.
| Member | Type | Rules |
|---|
box required | null or array of unit | |
polygon required | array of array of unit | max items 8 |
word
| Member | Type | Rules |
|---|
text required | string | min length 0; max length 2048 |
region required | region | |
confidence required | null or unit | |
line
| Member | Type | Rules |
|---|
text required | string | min length 0; max length 8192 |
region required | region | |
confidence required | null or unit | |
words required | array of word | max items 2048 |
block
| Member | Type | Rules |
|---|
text required | string | min length 0; max length 65536 |
region required | region | |
lines required | array of line | max items 10000 |
page
| Member | Type | Rules |
|---|
index required | integer | min 0; max 199 |
width required | integer | min 1; max 20000 |
height required | integer | min 1; max 20000 |
engine required | string | min length 1; max length 128; pattern ^[\x20-\x7e]+$ |
text required | string | min length 0; max length 262144 |
blocks required | array of block | max items 2000 |