Tools to Capture and Convert the Web

Error Handling with Python

Python API

In order to enable developers to programmatically handle errors, when a error occurs the GrabzIt Python API throws a GrabzItException which contains a error code that directly maps to a error. How each error code maps to an error is indicated in the below table, this avoids the need to parse error messages.

An example of a GrabzItException exception using error codes to determine how to handle a error is shown below.

try:
    grabzIt = GrabzItClient.GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret")
    grabzIt.URLToImage("https://www.tesla.com")
    grabzIt.SaveTo("images/result.jpg")
except GrabzItException as e:
    if e.Code == GrabzItException.GrabzItException.PARAMETER_NO_URL:
        # Please enter a URL

Error Code Lookup

Error Value Description Code
PARAMETER_NO_URL URL is missing 100
PARAMETER_INVALID_URL Specified URL is invalid 101
PARAMETER_NON_EXISTANT_URL Specified URL does not exist 102
PARAMETER_MISSING_APPLICATION_KEY Application key is missing 103
PARAMETER_UNRECOGNISED_APPLICATION_KEY Application key is not recognised 104
PARAMETER_MISSING_SIGNATURE Signature is missing 105
PARAMETER_INVALID_SIGNATURE Signature is invalid 106
PARAMETER_INVALID_FORMAT Specified format is invalid 107
PARAMETER_INVALID_COUNTRY_CODE Specified country code is invalid 108
PARAMETER_DUPLICATE_IDENTIFIER Specified identifier already exists 109
PARAMETER_MATCHING_RECORD_NOT_FOUND Matching record not found 110
PARAMETER_INVALID_CALLBACK_URL Specified callback URL is invalid 111
PARAMETER_NON_EXISTANT_CALLBACK_URL Callback URL does not exist 112
PARAMETER_IMAGE_WIDTH_TOO_LARGE Specified image width too large 113
PARAMETER_IMAGE_HEIGHT_TOO_LARGE Specified image height too large 114
PARAMETER_BROWSER_WIDTH_TOO_LARGE Specified browser height too large 115
PARAMETER_BROWSER_HEIGHT_TOO_LARGE Specified browser width too large 116
PARAMETER_DELAY_TOO_LARGE Specified delay too large 117
PARAMETER_INVALID_BACKGROUND Invalid background parameter for PDF 118
PARAMETER_INVALID_INCLUDE_LINKS Invalid include links parameter for PDF 119
PARAMETER_INVALID_INCLUDE_OUTLINE Invalid include outline parameter for PDF 120
PARAMETER_INVALID_PAGE_SIZE Invalid PDF page size 121
PARAMETER_INVALID_PAGE_ORIENTATION Invalid page orientation for PDF 122
PARAMETER_VERTICAL_MARGIN_TOO_LARGE Vertical margin for PDF too large 123
PARAMETER_HORIZONTAL_MARGIN_TOO_LARGE Horizontal margin for PDF too large 124
PARAMETER_INVALID_COVER_URL Invalid cover URL for PDF 125
PARAMETER_NON_EXISTANT_COVER_URL Specified cover URL for PDF does not exist 126
PARAMETER_MISSING_COOKIE_NAME Missing cookie name 127
PARAMETER_MISSING_COOKIE_DOMAIN Missing cookie domain 128
PARAMETER_INVALID_COOKIE_NAME Invalid cookie name 129
PARAMETER_INVALID_COOKIE_DOMAIN Invalid cookie domain 130
PARAMETER_INVALID_COOKIE_DELETE Invalid cookie delete value 131
PARAMETER_INVALID_COOKIE_HTTP Invalid cookie HTTP value 132
PARAMETER_INVALID_COOKIE_EXPIRY Invalid cookie expiry 133
PARAMETER_INVALID_CACHE_VALUE Invalid cache value 134
PARAMETER_INVALID_DOWNLOAD_VALUE Invalid download value 135
PARAMETER_INVALID_SUPPRESS_VALUE Invalid suppress value 136
PARAMETER_MISSING_WATERMARK_IDENTIFIER Missing watermark identifier 137
PARAMETER_INVALID_WATERMARK_IDENTIFIER Invalid watermark identifier 138
PARAMETER_INVALID_WATERMARK_XPOS Invalid watermark x position 139
PARAMETER_INVALID_WATERMARK_YPOS Invalid watermark y position 140
PARAMETER_MISSING_WATERMARK_FORMAT Watermark not found 141
PARAMETER_WATERMARK_TOO_LARGE Watermark too large 142
PARAMETER_MISSING_PARAMETERS Missing parameters 143
PARAMETER_QUALITY_TOO_LARGE Quality parameter too large 144
PARAMETER_QUALITY_TOO_SMALL Quality parameter too small 145
PARAMETER_REPEAT_TOO_SMALL Repeat parameter too small 149
PARAMETER_INVALID_REVERSE Reverse parameter invalid 150
PARAMETER_FPS_TOO_LARGE Frames per second parameter too large 151
PARAMETER_FPS_TOO_SMALL Frames per second parameter too small 152
PARAMETER_SPEED_TOO_FAST Speed parameter too fast 153
PARAMETER_SPEED_TOO_SLOW Speed parameter too slow 154
PARAMETER_INVALID_COMBINATION The combination of the duration, FPS, width and height parameters is too large 155
PARAMETER_START_TOO_SMALL Start parameter too small 156
PARAMETER_DURATION_TOO_SMALL Duration parameter too small 157
PARAMETER_NO_HTML No HTML was specified 163
PARAMETER_INVALID_TARGET_VALUE Invalid target specified 165
PARAMETER_INVALID_HIDE_VALUE Invalid element to hide specified 166
PARAMETER_INVALID_INCLUDE_IMAGES Include links parameter for DOCX 167
PARAMETER_INVALID_EXPORT_URL Invalid export URL 168
PARAMETER_INVALID_WAIT_FOR_VALUE Invalid wait for specified 169
PARAMETER_INVALID_TRANSPARENT_VALUE Invalid transparent specified 170
PARAMETER_INVALID_ENCRYPTION_KEY Invalid encryption key specified 171
PARAMETER_INVALID_NO_ADS Invalid advert value specified 172
PARAMETER_INVALID_PROXY Invalid HTTP proxy settings provided 173
PARAMETER_INVALID_NO_NOTIFY Invalid cookie notification value specified 174
PARAMETER_INVALID_HD Invalid high definition value specified 176
PARAMETER_INVALID_MEDIA_TYPE Invalid media type value specified 177
PARAMETER_INVALID_PASSWORD Invalid password value specified 178
PARAMETER_INVALID_MERGE Invalid merge identifier specified 179
PARAMETER_INVALID_CLICK_VALUE Invalid CSS selector to click specified 180
NETWORK_SERVER_OFFLINE Server offline 200
NETWORK_GENERAL_ERROR General network error 201
NETWORK_DDOS_ATTACK Distributed Denial of Service attack 202
RENDERING_ERROR General rendering error 300
RENDERING_MISSING_SCREENSHOT Missing screenshot 301
GENERIC_ERROR General error 400
UPGRADE_REQUIRED Upgrade required 500
FILE_SAVE_ERROR File save error 600
FILE_NON_EXISTANT_PATH File path does not exist 601