GET Keyword

Syntax

GET "url-or-path"

Parameters

"url-or-path" – Either an HTTP/HTTPS URL (e.g., https://api.example.com/data) or a relative path to an object stored in the configured MinIO bucket.

Description

GET fetches the content from the specified location.

If the argument starts with http:// or https://, the keyword performs an HTTP GET request using a timeout‑protected reqwest client. The response must have a successful status code; otherwise a runtime error is raised.
If the argument does not start with a scheme, it is treated as a path inside the bot’s MinIO bucket. The keyword reads the object, automatically handling PDF extraction when the file ends with .pdf. The content is returned as a UTF‑8 string.

The fetched content can be stored in a variable or passed to other keywords such as TALK or FORMAT.

Example (HTTP)

SET data = GET "https://api.example.com/users"
TALK "Received data: " + data

Example (Bucket file)

SET report = GET "reports/summary.txt"
TALK "Report content:\n" + report

Security

The implementation validates the path to prevent directory traversal (..) and other unsafe patterns. Invalid or unsafe paths cause a runtime error.

Implementation Notes

The request runs in a separate thread with its own Tokio runtime to avoid blocking the main engine.
Network timeouts are set to 30 seconds; connection timeouts to 10 seconds.
For bucket access, the keyword ensures the bucket exists before attempting to read.