Get File Changes pages for specific file in specified audit run

v3 API/

Get File Changes pages for specific file in specified audit run

Request

POST /v3/web-audits/{auditId}/runs/{runId}/reports/file-changes/file-pages

Security

API_Key

Path

auditIdinteger, (int64)required

Unique identification number for web audit

Example:107239

runIdinteger, (int64)required

Unique identification number for web audit or journey run

Example:33010

Query

pageinteger, >= 0

Page number, starts with 0

Default:0

sizeinteger, [ 50 .. 1000 ]

Default:50

sortBystring

Enum:"page_url""final_page_url""page_load_time""page_status_code""final_page_status_code"

sortDescboolean

Controls sorting order

Default:false

Bodyapplication/jsonrequired

Filters applicable to File Changes report

pageUrlobject

finalPageUrlobject

pageTitleobject

initialPageStatusCodeobject

finalPageStatusCodeobject

combinedPageStatusCodestring

broken - initial or final URL are broken,
good - initial URL is good or redirect and final URL is good

Enum:"broken""good"

pageLoadTimeobject

Page load time in milliseconds. Should have min and/or max properties defined. min is inclusive and max is exclusive. min should be less than max.

pageSizeobject

Page size in bytes. Should have min and/or max properties defined. min is inclusive and max is exclusive. min should be less than max.

redirectCountobject

Number of redirects for a page. Should have min and/or max properties defined. min is inclusive and max is exclusive. min should be less than max.

hasBrokenLinksboolean

dateDifferenceobject

Filters absolute difference values, e.g. when min = 200 then -300 diff passes filter. Should have min and/or max properties defined. min is inclusive, max is exclusive.

sizeDifferenceobject

Filters absolute difference values, e.g. when min = 200 then -300 diff passes filter. Should have min and/or max properties defined. min is inclusive, max is exclusive.

fileobjectrequired

changeTypestring

Enum:"new_file""not_changed""changed_file""deleted_file""unknown"

pageStatusCodestringdeprecated

good - 2xx, redirects - 3xx, broken - all others

Enum:"good""redirects""broken"

curl -i -X POST \
  'https://api.observepoint.com/v3/web-audits/107239/runs/33010/reports/file-changes/file-pages?page=0&size=50&sortBy=page_url&sortDesc=false' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "pageUrl": {
      "filterType": "contains",
      "filterValue": "string",
      "negated": false
    },
    "finalPageUrl": {
      "filterType": "contains",
      "filterValue": "string",
      "negated": false
    },
    "pageTitle": {
      "filterType": "contains",
      "filterValue": "ObserveP"
    },
    "initialPageStatusCode": {
      "filterType": "specific",
      "negated": true,
      "filterValue": 0
    },
    "finalPageStatusCode": {
      "filterType": "specific",
      "negated": true,
      "filterValue": 0
    },
    "combinedPageStatusCode": "broken",
    "pageLoadTime": {
      "min": 0,
      "max": 0
    },
    "pageSize": {
      "min": 0,
      "max": 0
    },
    "redirectCount": {
      "min": 0,
      "max": 0
    },
    "hasBrokenLinks": true,
    "pageStatusCode": "good",
    "dateDifference": {
      "min": 1,
      "max": 1
    },
    "sizeDifference": {
      "min": 1,
      "max": 1
    },
    "file": {
      "filename": "main.js",
      "requestDomain": "example.com",
      "partyType": "1st_party",
      "fileChangeType": "new_file",
      "tagId": 0
    },
    "changeType": "new_file"
  }'

Responses

File Changes pages data for specific file

Bodyapplication/json

metadataobjectrequired

Common metadata for iterable

pagesArray of objectsrequired

Response

{
  "metadata": {
    "pagination": { … }
  },
  "pages": [
    { … }
  ]
}