# getWebText

Canonical ID: `network.getText`.

```text
getWebText(url)
```

Fetches a public HTTPS URL and returns a Map with `ok`, `status`, `value` and `error`. On success, `value` contains UTF-8 text; on failure it is `None`. Only HTTP 2xx succeeds. Check `ok` before using the value.

Declare the HTTPS origin in a saved project through File → Project web access. The user must grant access for each run. A declaration alone is not permission. Loose source files have no declarations. Private networks, localhost, redirects outside the same origin, arbitrary headers and ambient cookies are prohibited. Requests have timeout, size and rate limits.

Failures use `unavailable`, `invalid-url`, `denied`, `timeout`, `cancelled`, `limit`, `http`, `invalid-response` or `network`. Results contain no raw transport details or secrets. Wrong argument types produce a runtime diagnostic. JSON replies require a JSON content type, valid UTF-8 and valid bounded values.

CLI, IDE and native console/graphical applications support this with permission. Local browser projects can use the explicit Go broker; a public browser without an adapter returns `unavailable`. Stopping or revoking web access cancels requests. These functions are included in Learner.

```pliro
# language: en
let reply = getWebText("https://api.example.org/data")
if reply["ok"]:
    say reply["value"]
else:
    say reply["error"]
```

Replace the example URL with your own permitted public API; this address does not supply demo data.