2
2
3
3
:bulb : Before you start: if you just want to play with an online demo, visit our [ playground] ( https://api.regulaforensics.com ) .
4
4
5
+ :warning : NOTE: If a custom Document Reader endpoint is not specified, demo web API will be used by default.
6
+ By sending requests to demo Regula Document Reader web API,
7
+ you agree with our [ Privacy Policy] ( https://api.regulaforensics.com/terms )
8
+ and [ License Agreement] ( https://downloads.regulaforensics.com/work/SDK/doc/Eula.pdf ) .
9
+
10
+
5
11
Requirements:
6
12
- installed java 11+
7
13
8
- Verify Java version:
14
+ Java version verification :
9
15
``` bash
10
16
java --version
11
17
> openjdk 14.0.1 2020-04-14
12
18
```
13
19
14
- Cloning example :
20
+ Example of cloning :
15
21
``` bash
16
22
git clone https://github.com/regulaforensics/DocumentReader-web-java-client.git
17
23
cd DocumentReader-web-java-client
18
24
```
19
25
20
- ### Running with local Regula Document Reader web API installation
26
+ ### Running the client with demo Regula Document Reader web API
27
+ :warning : NOTE: for some systems, the ` gradlew.bat ` command should be used instead of ` ./gradlew ` .
21
28
22
- :warning : NOTE: for some systems ` gradlew.bat ` command should be used, instead of ` ./gradlew ` .
23
-
24
- Follow [ the instructions] ( https://docs.regulaforensics.com/web/quick-start-guide ) to run Regula Document Reader web API.
25
- Assuming you have successfully launched instance, use next line command to run example:
29
+ Example of execution:
26
30
``` bash
27
31
./gradlew :example:run
28
-
29
- # If Regula Document Reader web API is running not on localhost, specify host via env variable:
30
- API_BASE_PATH=" http://192.168.0.101:8080" ./gradlew :example:run
31
32
```
32
33
33
- ### Running using Regula Document Reader web API test SaaS
34
+ ### Running the client with local Regula Document Reader web API installation
35
+ :warning : NOTE: for some systems, the ` gradlew.bat ` command should be used instead of ` ./gradlew ` .
34
36
35
- :warning : NOTE: for some systems ` gradlew.bat ` command should be used, instead of ` ./gradlew ` .
37
+ Get your [ free trial here] ( https://mobile.regulaforensics.com/ ) . When you receive the ` regula.license ` file,
38
+ copy it to the [ example resources] ( ../example/src/main/resources ) folder. Now you are ready for start!
36
39
37
- Get your [ free trial here ] ( https://mobile .regulaforensics.com/ ) . You should obtain ` regula.license ` file.
38
- Copy it to [ example resources ] ( ../example/src/main/resources ) folder. You are ready for running!
40
+ Follow [ the instructions ] ( https://docs .regulaforensics.com/web-service/quick-start-guide ) to run Regula Document Reader web API.
41
+ If the instance has been launched successfully, use the following line command to run the example:
39
42
40
- Execute example:
41
43
``` bash
42
- API_BASE_PATH=" https ://test-api.regulaforensics.com " ./gradlew :example:run
44
+ API_BASE_PATH=" http ://127.0.0.1:8080 " ./gradlew :example:run
43
45
```
44
46
45
47
### Output
46
- This sample generates next text output:
48
+ This sample generates the following text output:
47
49
``` text
48
50
---------------------------------------------------------------------------
49
51
Document Overall Status: not valid
@@ -54,5 +56,6 @@ This sample generates next text output:
54
56
MRZ-Visual values comparison: 1
55
57
---------------------------------------------------------------------------
56
58
```
57
- Also, it creates [ portrait] ( portrait.jpg ) and [ document image] ( document-image.jpg ) pictures inside current folder.
58
- Edit [ example] ( ../example/src/main/java/com/regula/documentreader/webclient/example/Main.java ) on your own , and re-run to see your results.
59
+ Also, it stores [ portrait] ( portrait.jpg ) and [ document image] ( document-image.jpg ) images in the current folder.
60
+ You can modify [ this example] ( ../example/src/main/java/com/regula/documentreader/webclient/example/Main.java )
61
+ and re-run it to get your own results.
0 commit comments