Generates a Universally Unique Identifier (UUID).

GenerateGUID returns a UUID version 4 string as defined by RFC 4122, which is generated pseudo-randomly.

If wrapInCurlyBraces is true, then the returned string will begin and end with curly braces ({}). If false, then the braces are omitted.

Sends a GET request to a website.

See the HttpService Details section for information regarding all request functions.

GetAsync makes a request using the GET method. url is the URL to which the request will be sent. If nocache is true, then the Cache-Control header of the request will be set to no-cache. headers is an optional table of HTTP headers.

If successful, GetAsync returns the body of the response.

headers is an optional table for specifying additional headers to be included with the request. Each entry must be a key-value pair, where the key is a string indicating a header name, and the value is a string indicating the header value.

If the response returns a non-successful status code, then the status is thrown as an error:

HTTP 000 (MESSAGE)

Where 000 is the status code, and MESSAGE is the status message.

Bugs

Cache-Control is set to no-cache regardless of the nocache argument.

Decodes a JSON-formatted string into a value. The string is decoded according to RFC8259.

The following JSON types are converted into a corresponding Lua type:

• A null is decoded into a Lua nil.
• A boolean is decoded into a Lua boolean.
• A number is decoded into the nearest representing Lua number.
• A string is decoded into a Lua string.
• An array is decoded into a Lua table, where each entry in the array is an entry in the table, with indices starting at 1.
• An object is decoded into a Lua table, where each field of the object is a key-value pair in the table.

Encodes input into a JSON-formatted string. input cannot be nil.

A boolean is mapped directly to a JSON boolean. A number is encoded as a JSON number. Infinity and NaN are encoded as a JSON null.

A string is encoded as a UTF-8 string. The following characters are escaped:

Control characters (0x00 - 0x1F) not in this list are escaped as \u00XX, where XX is the character code in hexadecimal.

Other unicode characters are encoded as-is. A malformed unicode character within any encoded string causes the following error to be thrown:

Can't convert to JSON

A table is encoded as either a JSON array or a JSON object, which depends on the content. A table is interpreted as an array if it is empty, or if it contains the integer 1 as a key. Otherwise, it is treated as an object.

Tables are encoded recursively. If a table that is being or has already been encoded is traversed, the following error is thrown:

tables cannot be cyclic

A table interpreted as an array encodes integer keys from 1 to the length of the table. Other keys are ignored, and are not traversed.

A table interpreted as an object encodes certain types of keys to JSON strings. Keys are encoded in the same way as string values. The method for encoding non-string keys is undefined. It is possible that such a key will be converted to a string, throw an error, or be ignored entirely.

Other types are encoded as a JSON null.

Sends a POST request to a website.

PostAsync makes a request using the POST method. url is the URL to which the request will be sent, and data is the body of the request.

content_type optionally sets the Content-Type header according to the given HttpContentType value.

compress optionally determines whether the body will be compressed with gzip encoding. The body will be sent compressed only if the compressed content is shorter than the uncompressed content. If compressed, then the Content-Encoding header is set to gzip.

headers is an optional table for specifying additional headers to be included with the request. Each entry must be a key-value pair, where the key is a string indicating a header name, and the value is a string indicating the header value.

If the response returns a non-successful status code, then the status is thrown as an error:

HTTP 000 (MESSAGE)

Where 000 is the status code, and MESSAGE is the status message.

The length of data cannot be greater than or equal to 1024KB (maximum is 1,023,999 bytes). If data is too large, then the following error will be thrown:

Post data too large. Limit: 1024 KB. Post size: SIZE KB

Where SIZE is the length of data in kilobytes. Note that RequestAsync does not have this limit.

Sends an HTTP request and receives the response.

See the HttpService Details section for information regarding all request functions.

requestOptions specifies the content of the request using the following fields:

If Url has a blacklisted Roblox domain, then the following error will be thrown:

HttpService is not allowed to access ROBLOX resources

Method, which is case-sensitive, must be one of GET, HEAD, POST, PUT, DELETE, TRACE, OPTIONS, CONNECT, or PATCH. If Method is GET or HEAD, and Body is specified, then the following error will be thrown:

Invalid request options, Body should be empty for 'GET' or 'HEAD' method

RequestAsync blocks until a response has been received and processed, or the request has timed out.

Each entry to the Headers table must be a key-value pair, where the key is a string indicating a header name, and the value is a string indicating the header value.

Response

If successful, RequestAsync returns response data as a table with the following fields:

The response Headers field is a table, where each key is a string indicating a header name, and the value is a string indicating the header value. Header names, which are case-insensitive, are normalized to lowercase. If a header was sent multiple times, the value of the latest such header is selected.