If the ArcWeb Services REST API encounters a problem while processing your request, the REST API returns a message designed to help you understand the issue. You are not charged for this transaction. Most often, the actual error message also includes information about the problem in a request and what was expected, for example:
Invalid center point (c) parameter value: <value>. The x and y coordinates of the center point should be numeric and separated by a pipeline (|).
The actual message text you see may be slightly different from what is listed here, but the general idea of the message remains consistent.
NOTE: REST parameter names and values are case sensitive. If your REST URL contains the wrong case, you will receive an error. See Mapping parameters for details on valid values for parameters.
See SOAP error messages for a list of error messages returned from SOAP ArcWeb Services.
The messages are listed alphabetically.
Access to the specified resource (No token or userid supplied) has been forbidden.
Access to the specified resource (Invalid userid) has been forbidden.
Access to the specified resource (Wrong token format) has been forbidden.
The server encountered an internal error (Invalid userid) that prevented it from fulfilling this request.
The server encountered an internal error (1021: Token has expired.) that prevented it from fulfilling this request.
The request sent by the client was syntactically incorrect (Invalid data source name: "<value>".).
The request sent by the client was syntactically incorrect (Invalid style sheet name: "<value>".).
The request sent by the client was syntactically incorrect (Missing "actn" parameter.).
The server does not support the functionality needed to fulfill this request (Not Implemented).
Invalid angle ("a") parameter value: <value>. The value should be numeric.
Invalid center point ("c") parameter value: <value>. The x and y coordinates of the center point should be numeric and separated by a pipeline (|).
Invalid center point ("c") value: <value>. The x and y coordinates of the center point should be numeric and separated by a pipeline (|).
Invalid "dc" parameter value: <value>. The x and y coordinates should be numeric and separated by a pipeline (|).
Required data source ("ds") parameter is missing.
Invalid image format ("fmt") parameter value: <value>. Valid values are: svg, swf, jpg, png.
Invalid height ("h") parameter value: <value>. The value should be a positive integer, not greater than 8192.
Invalid width ("w") parameter value: <value>. The value should be a positive integer, not greater than 8192.
Invalid scale ("sf") parameter value: <value>. The value should be a numeric, greater than zero.
Required center point ("c") parameter is missing.
Required scale ("sf") parameter is missing.
Unsupported coordinate system format for "cmr" parameter: <value>.
Unsupported format for "cmr" parameter: <value>.
Invalid acetate line ("ln") parameter value: <value>. The x and y coordinates of acetate line should be numeric and separated by a pipeline (|).
Invalid line width ("lnw") parameter value: <value>. The value should be a positive integer and greater than 0 and not greater than 10.
Invalid line color ("lnc") parameter value: <value>. The value should be in RRGGBB or AARRGGBB format (html hexadecimal color) where AA represents transparency.
Invalid acetate point ("p") parameter value: <value>. The x and y coordinates of acetate points should be numeric and separated by a pipeline (|).
The number of labels should not be greater than number of acetate points.
The number of icons should not be greater than number of acetate points.
Invalid acetate polygon ("plg") parameter value: <value>. The x and y coordinates of acetate polygon should be numeric and separated by a pipeline (|).
Invalid polygon color ("plg") parameter value: <value>. The value should be in RRGGBB or AARRGGBB format (html hexadecimal color) where AA represents transparency.
Invalid graticule color ("gc") parameter value: <value>. The value should be in RRGGBB or AARRGGBB format (html hexadecimal color) where AA represents transparency.
Invalid graticule distance ("g") parameter value: <value>. The value should be numeric and greater than zero and not greater than 30.
Invalid graticule width ("gw") parameter value: <value>. The value should be a positive integer and greater than 0 and not greater than 10.
Invalid legend ("l") parameter value: <value>. The x and y coordinates of the upper left corner of legend are in pixels. Values should be positive integer and separated by a pipeline (|).
Invalid north arrow center point ("na") parameter value: <value>. The x and y coordinates of the center point should be integer and separated by a pipeline (|).
Invalid north arrow height ("nah") parameter value: <value>. The value should be a positive integer.
Invalid north arrow type ("nat") parameter value: <value>. Valid values are bk, bu, gr.
Invalid north arrow width ("naw") parameter value: <value>. The value should be a positive integer.
Required north arrow type ("nat") parameter is missing. Valid values are bk, bu, gr.
Invalid scale bar origin ("sbx") parameter value: <value>. The x and y coordinates of the lower left corner of scale bar are in pixels. Values should be positive integer and separated by a pipeline (|).
Invalid scale bar width ("sbw") parameter value: <value>. The value should be a positive integer.
Invalid scale bar type ("sbt") parameter value: <value>. Valid values are 1 or 2.
Unsupported projection for "ocs" parameter: <value>
Unsupported coordinate system format for "ocs" parameter: <value>
Raster tile HTTP error messages can be turned on using the re parameter. If the re parameter is set to true, the following HTTP errors will be returned instead of a "Map Imagery Not available" image:
Bad parameter: HTTP 400 (Bad Request)
Server error: HTTP 500 (Server Error)
Tile doesn't exist: HTTP 404 (File Not Found)
When a bad parameter is sent, an "Invalid parameter: X" message displays where X is the parameter name. Invalid parameter messages for raster tile requests are:
Invalid parameter: ds
Invalid parameter: lev
Invalid parameter: row
Invalid parameter: col
Invalid parameter: ds
Invalid parameter: ds
Invalid parameter: w
Invalid parameter: h
Invalid parameter: c
Invalid parameter: sf
Visit the Feedback page to give comments or suggestions about the ArcWeb Developer's Guide.