This article describes how to utilize the PDF Scout inspector to analyze incoming plan review documents.
Prerequisites
- A user account with administrator privileges for an EPR website.
- Login to the EPR domain as a user with administrator privileges.
See: Scout PDF Inspector
Step-by-step guide
To inspect a pdf file using Scout APIs, follow these steps:
Get a login token for an administrator. See Accessing the Connect API for partner integration via Swagger
- Get upload url
- Upload file using the url from step 2
- Call Scout to get the json result.
Step 1. Get token
POST https://scout-api.eplansoftreview.com/api/auth
...
| Code Block |
|---|
{
"username": "youradmin_username",
"password": "youradmin_password"
} |
Sample Response:
...
| Code Block |
|---|
{
"success": true,
"data": {
"filename": "1525449678912sample.pdf",
"filesize": 73121,
"numPages": 1,
"outlines": null,
"results": [
{
"key": "accessible",
"success": true,
"value": null
},
{
"key": "version",
"success": true,
"value": "1.7"
},
{
"key": "size",
"success": true,
"value": "0.07MB"
},
{
"key": "rotation",
"success": true,
"value": null
},
{
"key": "pageAccess",
"success": true,
"value": null
},
{
"key": "annotation",
"success": true,
"value": null
},
{
"key": "resolution",
"success": true,
"value": null
}
],
"pages": [
{
"pageNumber": 1,
"dimension": {
"pageNumber": 1,
"mediaBox": [
0,
0,
1728,
1296
],
"rotate": 0,
"orientation": "Landscape",
"width": 1728,
"height": 1296
},
"pageAccess": {
"value": null,
"errMessage": null,
"debugData": null
},
"annotation": {
"value": null,
"errMessage": null,
"debugData": null
},
"resolution": {
"value": null,
"errMessage": null,
"debugData": null
}
}
],
"pageDimensions": {
"1": {
"pageNumber": 1,
"mediaBox": [
0,
0,
1728,
1296
],
"rotate": 0,
"orientation": "Landscape",
"width": 1728,
"height": 1296
}
},
"author": "",
"version": 1.7,
"isPassed": true
}
} |
Determining the Results
Check "isPassed" value in the response body to see if you the file passes the inspectorScout. EPR will not accept plan review documents rejected by Scout.