22
33:bulb : Before you start: if you just want to play with an online demo, visit our [ playground] ( https://api.regulaforensics.com ) .
44
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+
511Requirements:
612- installed java 11+
713
8- Verify Java version:
14+ Java version verification :
915``` bash
1016java --version
1117> openjdk 14.0.1 2020-04-14
1218```
1319
14- Cloning example :
20+ Example of cloning :
1521``` bash
1622git clone https://github.com/regulaforensics/DocumentReader-web-java-client.git
1723cd DocumentReader-web-java-client
1824```
1925
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 ` .
2128
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:
2630``` bash
2731./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
3132```
3233
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 ` .
3436
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!
3639
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:
3942
40- Execute example:
4143``` 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
4345```
4446
4547### Output
46- This sample generates next text output:
48+ This sample generates the following text output:
4749``` text
4850 ---------------------------------------------------------------------------
4951 Document Overall Status: not valid
@@ -54,5 +56,6 @@ This sample generates next text output:
5456 MRZ-Visual values comparison: 1
5557 ---------------------------------------------------------------------------
5658```
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