# haalWebTekst

Canonieke ID: `network.getText`.

```text
haalWebTekst(url)
```

Vraagt een openbaar HTTPS-adres op en geeft een Map terug met `ok`, `status`, `value` en `error`. `value` bevat UTF-8-tekst bij succes, anders `None`. Alleen HTTP 2xx is succes. Controleer `ok` voordat je de waarde gebruikt.

Declareer de HTTPS-origin in een opgeslagen project via Bestand → Projectwebtoegang. De gebruiker moet voor elke uitvoering toestemming geven. Een declaratie alleen is geen toestemming. Losse bronbestanden hebben geen declaraties. Privénetwerken, localhost, omleidingen buiten dezelfde origin, willekeurige headers en omgevingscookies zijn niet toegestaan. Verzoeken hebben tijd-, omvang- en snelheidsgrenzen.

Fouten gebruiken `unavailable`, `invalid-url`, `denied`, `timeout`, `cancelled`, `limit`, `http`, `invalid-response` of `network`. Er zijn geen transportdetails of geheime gegevens in het resultaat. Ongeldige argumenttypen geven een uitvoerdiagnose. JSON-antwoorden vereisen een JSON-contenttype, geldige UTF-8 en geldige begrensde waarden.

CLI, IDE en native console-/grafische apps ondersteunen dit met toestemming. Lokale browserprojecten kunnen de expliciete Go-broker gebruiken; een publieke browser zonder adapter geeft `unavailable`. Stoppen of webtoegang intrekken annuleert verzoeken. Deze functies zijn beschikbaar in Learner.

```pliro
# language: nl
laat antwoord = haalWebTekst("https://api.example.org/data")
als antwoord["ok"]:
    zeg antwoord["value"]
anders:
    zeg antwoord["error"]
```

Vervang het voorbeeldadres door je eigen toegestane openbare API; dit adres levert geen demonstratiegegevens.