wren/manual/howto/http-requests.html

<!DOCTYPE html>
<!-- retoor <retoor@molodetz.nl> -->
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Making HTTP Requests - Wren-CLI Manual</title>
    <link rel="stylesheet" href="../css/style.css">
</head>
<body>
    <button class="mobile-menu-toggle">Menu</button>
    <div class="container">
        <aside class="sidebar">
            <div class="sidebar-header">
                <h1><a href="../index.html">Wren-CLI</a></h1>
                <div class="version">v0.4.0</div>
            </div>
            <nav class="sidebar-nav">
                <div class="section">
                    <span class="section-title">Getting Started</span>
                    <ul>
                        <li><a href="../getting-started/index.html">Overview</a></li>
                        <li><a href="../getting-started/installation.html">Installation</a></li>
                        <li><a href="../getting-started/first-script.html">First Script</a></li>
                        <li><a href="../getting-started/repl.html">Using the REPL</a></li>
                    </ul>
                </div>
                <div class="section">
                    <span class="section-title">Language</span>
                    <ul>
                        <li><a href="../language/index.html">Syntax Overview</a></li>
                        <li><a href="../language/classes.html">Classes</a></li>
                        <li><a href="../language/methods.html">Methods</a></li>
                        <li><a href="../language/control-flow.html">Control Flow</a></li>
                        <li><a href="../language/fibers.html">Fibers</a></li>
                        <li><a href="../language/modules.html">Modules</a></li>
                    </ul>
                </div>
                <div class="section">
                    <span class="section-title">API Reference</span>
                    <ul>
                        <li><a href="../api/index.html">Overview</a></li>
                        <li><a href="../api/string.html">String</a></li>
                        <li><a href="../api/number.html">Num</a></li>
                        <li><a href="../api/argparse.html">argparse</a></li>
                        <li><a href="../api/base64.html">base64</a></li>
                        <li><a href="../api/crypto.html">crypto</a></li>
                        <li><a href="../api/dataset.html">dataset</a></li>
                        <li><a href="../api/datetime.html">datetime</a></li>
                        <li><a href="../api/dns.html">dns</a></li>
                        <li><a href="../api/env.html">env</a></li>
                        <li><a href="../api/fswatch.html">fswatch</a></li>
                        <li><a href="../api/html.html">html</a></li>
                        <li><a href="../api/http.html">http</a></li>
                        <li><a href="../api/io.html">io</a></li>
                        <li><a href="../api/jinja.html">jinja</a></li>
                        <li><a href="../api/json.html">json</a></li>
                        <li><a href="../api/markdown.html">markdown</a></li>
                        <li><a href="../api/math.html">math</a></li>
                        <li><a href="../api/net.html">net</a></li>
                        <li><a href="../api/os.html">os</a></li>
                        <li><a href="../api/pathlib.html">pathlib</a></li>
                        <li><a href="../api/regex.html">regex</a></li>
                        <li><a href="../api/scheduler.html">scheduler</a></li>
                        <li><a href="../api/signal.html">signal</a></li>
                        <li><a href="../api/sqlite.html">sqlite</a></li>
                        <li><a href="../api/subprocess.html">subprocess</a></li>
                        <li><a href="../api/sysinfo.html">sysinfo</a></li>
                        <li><a href="../api/tempfile.html">tempfile</a></li>
                        <li><a href="../api/timer.html">timer</a></li>
                        <li><a href="../api/tls.html">tls</a></li>
                        <li><a href="../api/udp.html">udp</a></li>
                        <li><a href="../api/uuid.html">uuid</a></li>
                        <li><a href="../api/wdantic.html">wdantic</a></li>
                        <li><a href="../api/web.html">web</a></li>
                        <li><a href="../api/websocket.html">websocket</a></li>
                    </ul>
                </div>
                <div class="section">
                    <span class="section-title">Tutorials</span>
                    <ul>
                        <li><a href="../tutorials/index.html">Tutorial List</a></li>
                        <li><a href="../tutorials/http-client.html">HTTP Client</a></li>
                        <li><a href="../tutorials/websocket-chat.html">WebSocket Chat</a></li>
                        <li><a href="../tutorials/database-app.html">Database App</a></li>
                        <li><a href="../tutorials/template-rendering.html">Templates</a></li>
                        <li><a href="../tutorials/cli-tool.html">CLI Tool</a></li>
                        <li><a href="../tutorials/web-server.html">Web Server</a></li>
                    </ul>
                </div>
                <div class="section">
                    <span class="section-title">How-To Guides</span>
                    <ul>
                        <li><a href="index.html">How-To List</a></li>
                        <li><a href="http-requests.html" class="active">HTTP Requests</a></li>
                        <li><a href="json-parsing.html">JSON Parsing</a></li>
                        <li><a href="regex-patterns.html">Regex Patterns</a></li>
                        <li><a href="file-operations.html">File Operations</a></li>
                        <li><a href="async-operations.html">Async Operations</a></li>
                        <li><a href="error-handling.html">Error Handling</a></li>
                    </ul>
                </div>
                <div class="section">
                    <span class="section-title">Contributing</span>
                    <ul>
                        <li><a href="../contributing/index.html">Overview</a></li>
                        <li><a href="../contributing/module-overview.html">Module Architecture</a></li>
                        <li><a href="../contributing/pure-wren-module.html">Pure-Wren Modules</a></li>
                        <li><a href="../contributing/c-backed-module.html">C-Backed Modules</a></li>
                        <li><a href="../contributing/foreign-classes.html">Foreign Classes</a></li>
                        <li><a href="../contributing/async-patterns.html">Async Patterns</a></li>
                        <li><a href="../contributing/testing.html">Writing Tests</a></li>
                        <li><a href="../contributing/documentation.html">Documentation</a></li>
                    </ul>
                </div>
            </nav>
        </aside>
        <main class="content">
            <nav class="breadcrumb">
                <a href="../index.html">Home</a>
                <span class="separator">/</span>
                <a href="index.html">How-To Guides</a>
                <span class="separator">/</span>
                <span>HTTP Requests</span>
            </nav>

            <article>
                <h1>Making HTTP Requests</h1>

                <h2>Basic GET Request</h2>
                <pre><code>import "http" for Http

var response = Http.get("https://api.example.com/data")
System.print(response.body)</code></pre>

                <h2>GET Request with JSON Response</h2>
                <pre><code>import "http" for Http

var response = Http.get("https://jsonplaceholder.typicode.com/posts/1")
var data = response.json

System.print("Title: %(data["title"])")</code></pre>

                <h2>GET Request with Headers</h2>
                <pre><code>import "http" for Http

var response = Http.get("https://api.example.com/data", {
    "Accept": "application/json",
    "User-Agent": "Wren-CLI/1.0"
})

System.print(response.body)</code></pre>

                <h2>POST Request with JSON Body</h2>
                <pre><code>import "http" for Http
import "json" for Json

var data = {
    "name": "John Doe",
    "email": "john@example.com"
}

var response = Http.post(
    "https://api.example.com/users",
    Json.stringify(data),
    {"Content-Type": "application/json"}
)

System.print("Status: %(response.statusCode)")
System.print("Created: %(response.json)")</code></pre>

                <h2>PUT Request</h2>
                <pre><code>import "http" for Http
import "json" for Json

var data = {
    "id": 1,
    "name": "Jane Doe",
    "email": "jane@example.com"
}

var response = Http.put(
    "https://api.example.com/users/1",
    Json.stringify(data),
    {"Content-Type": "application/json"}
)

System.print("Updated: %(response.statusCode == 200)")</code></pre>

                <h2>DELETE Request</h2>
                <pre><code>import "http" for Http

var response = Http.delete("https://api.example.com/users/1")
System.print("Deleted: %(response.statusCode == 204)")</code></pre>

                <h2>PATCH Request</h2>
                <pre><code>import "http" for Http
import "json" for Json

var response = Http.patch(
    "https://api.example.com/users/1",
    Json.stringify({"email": "newemail@example.com"}),
    {"Content-Type": "application/json"}
)

System.print("Patched: %(response.statusCode)")</code></pre>

                <h2>Bearer Token Authentication</h2>
                <pre><code>import "http" for Http

var token = "your-api-token"

var response = Http.get("https://api.example.com/protected", {
    "Authorization": "Bearer %(token)"
})

System.print(response.json)</code></pre>

                <h2>Basic Authentication</h2>
                <pre><code>import "http" for Http
import "base64" for Base64

var username = "user"
var password = "pass"
var credentials = Base64.encode("%(username):%(password)")

var response = Http.get("https://api.example.com/protected", {
    "Authorization": "Basic %(credentials)"
})

System.print(response.body)</code></pre>

                <h2>API Key Authentication</h2>
                <pre><code>import "http" for Http

var response = Http.get("https://api.example.com/data", {
    "X-API-Key": "your-api-key"
})

System.print(response.body)</code></pre>

                <h2>Check Response Status</h2>
                <pre><code>import "http" for Http

var response = Http.get("https://api.example.com/data")

if (response.statusCode == 200) {
    System.print("Success: %(response.json)")
} else if (response.statusCode == 404) {
    System.print("Not found")
} else if (response.statusCode >= 500) {
    System.print("Server error: %(response.statusCode)")
} else {
    System.print("Error: %(response.statusCode)")
}</code></pre>

                <h2>Access Response Headers</h2>
                <pre><code>import "http" for Http

var response = Http.get("https://api.example.com/data")

System.print("Content-Type: %(response.headers["content-type"])")
System.print("All headers: %(response.headers)")</code></pre>

                <h2>URL Query Parameters</h2>
                <pre><code>import "http" for Http

var response = Http.get("https://api.example.com/search?q=wren&limit=10")

System.print(response.json)</code></pre>

                <h2>Form URL Encoded POST</h2>
                <pre><code>import "http" for Http

var body = "username=john&password=secret"

var response = Http.post(
    "https://api.example.com/login",
    body,
    {"Content-Type": "application/x-www-form-urlencoded"}
)

System.print(response.json)</code></pre>

                <h2>Download File</h2>
                <pre><code>import "http" for Http
import "io" for File

var response = Http.get("https://example.com/file.txt")

if (response.statusCode == 200) {
    File.write("downloaded.txt", response.body)
    System.print("File downloaded!")
}</code></pre>

                <h2>HTTPS Request</h2>
                <pre><code>import "http" for Http

var response = Http.get("https://secure.example.com/api")
System.print(response.body)</code></pre>

                <h2>Error Handling</h2>
                <pre><code>import "http" for Http

var fiber = Fiber.new {
    return Http.get("https://api.example.com/data")
}

var response = fiber.try()

if (fiber.error) {
    System.print("Request failed: %(fiber.error)")
} else if (response.statusCode >= 400) {
    System.print("HTTP error: %(response.statusCode)")
} else {
    System.print("Success: %(response.json)")
}</code></pre>

                <h2>Retry on Failure</h2>
                <pre><code>import "http" for Http
import "timer" for Timer

var fetchWithRetry = Fn.new { |url, maxRetries|
    var attempt = 0
    while (attempt < maxRetries) {
        var fiber = Fiber.new { Http.get(url) }
        var response = fiber.try()

        if (!fiber.error && response.statusCode == 200) {
            return response
        }

        attempt = attempt + 1
        if (attempt < maxRetries) {
            Timer.sleep(1000 * attempt)
        }
    }
    return null
}

var response = fetchWithRetry.call("https://api.example.com/data", 3)
if (response) {
    System.print(response.json)
} else {
    System.print("Failed after 3 retries")
}</code></pre>

                <div class="admonition tip">
                    <div class="admonition-title">See Also</div>
                    <p>For a complete API client example, see the <a href="../tutorials/http-client.html">HTTP Client Tutorial</a>. For full API documentation, see the <a href="../api/http.html">HTTP module reference</a>.</p>
                </div>
            </article>

            <footer class="page-footer">
                <a href="index.html" class="prev">How-To List</a>
                <a href="json-parsing.html" class="next">JSON Parsing</a>
            </footer>
        </main>
    </div>
    <script src="../js/main.js"></script>
</body>
</html>