Difference between revisions of "Template:LSL Extended Error HTTP"

From Second Life Wiki
Jump to navigation Jump to search
(Created page with "{{#if: {{LSL Function/boolean|verify|if=*|td=the server SSL certificate must be verifiable using one of the standard certificate authorities|fd=any server SSL certificate wil...")
 
Line 18: Line 18:
}}
}}


|Extended Errors=
====Extended Errors====
When the [[HTTP_EXTENDED_ERROR]] parameter is [[TRUE]], llHTTPRequest will return extended error information to the script through the [[http_response]] event. A detailed error explanation is returned as a JSON blob in the body of the event and an error code is provided through the HTTP status. The format of the JSON blob is described in detail in [[https://tools.ietf.org/html/rfc7807 RFC 7807]].
When the [[HTTP_EXTENDED_ERROR]] parameter is [[TRUE]], llHTTPRequest will return extended error information to the script through the [[http_response]] event. A detailed error explanation is returned as a JSON blob in the body of the event and an error code is provided through the HTTP status. The format of the JSON blob is described in detail in [[https://tools.ietf.org/html/rfc7807 RFC 7807]].



Revision as of 18:16, 20 January 2021


Extended Errors

When the HTTP_EXTENDED_ERROR parameter is TRUE, llHTTPRequest will return extended error information to the script through the http_response event. A detailed error explanation is returned as a JSON blob in the body of the event and an error code is provided through the HTTP status. The format of the JSON blob is described in detail in [RFC 7807].

{
    "type":   "http://wiki.secondlife.com/wiki/llHTTPRequest", // reference to the documentation for llHTTPRequest.
    "title":  "Error Title", // A human readable title for the error.
    "detail": "Description of error condition.", // A human readable description of the error condition.
    "status": 400 // The HTTP Status for the call.
}


Error Description
Method Not Allowed 405 The HTTP method specified for HTTP_METHOD is not supported.
Unsupported Media Type 415 The mime type specified in HTTP_MIMETYPE or HTTP_ACCEPT is not supported.
Enhance Your Calm 420 HTTP requests have been throttled for this object, script, or owner. Back off making further HTTP calls until the throttle has cleared.
HTTP Unavailable 470 HTTP and/or HTTPS have been disabled in this region.
Invalid URL 471 The URL passed to llHTTPRequest contains invalid characters or uses a protocol other than http or https.
Parameter Error 472 There was an issue with the parameters passed to llHTTPRequest. One of the following conditions may be the problem
  • The type of the parameter value may be incorrect.
  • The parameter key may be something other than an integer.
  • A parameter may be missing.
  • The value for a parameter failed validation.
Illegal Request Header 473 A request header passed to HTTP_CUSTOM_HEADER is not allowed.
Too Many Headers 474 To many request headers have been specified with HTTP_CUSTOM_HEADER.