Sandbox.Http

// Simple GET
string response = await Http.RequestStringAsync("https://api.example.com/data");

// With headers
string response = await Http.RequestStringAsync("https://api.example.com/data", 
    HttpMethod.Get, 
    new Dictionary<string, string> { ["Authorization"] = $"Bearer {token}" });

// POST JSON
string json = "{\"name\":\"test\"}";
string response = await Http.RequestStringAsync("https://api.example.com/data", 
    HttpMethod.Post, 
    null, 
    json);

// GET and parse JSON
var data = await Http.RequestJsonAsync<MyResponse>("https://api.example.com/data");

// POST object as JSON
var result = await Http.RequestJsonAsync<ResponseType>("https://api.example.com/submit",
    HttpMethod.Post,
    null,
    requestObject);

try
{
    string response = await Http.RequestStringAsync(url);
}
catch (HttpRequestException ex)
{
    Log.Error($"HTTP request failed: {ex.Message}");
}

// Default timeout is 30 seconds
// Use cancellation token for custom timeout
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(10));
string response = await Http.RequestStringAsync(url, cancellationToken: cts.Token);

// Implement rate limiting to avoid being blocked
RealTimeSince lastRequest = 100;

async Task RateLimitedRequest()
{
    if (lastRequest < 1.0f) // 1 second between requests
    {
        await Task.Delay(1000);
    }
    
    var response = await Http.RequestStringAsync(url);
    lastRequest = 0;
}

public class LeaderboardAPI
{
    public async Task<Score[]> GetScores()
    {
        try
        {
            var token = await Auth.GetTokenAsync();
            var scores = await Http.RequestJsonAsync<Score[]>(
                "https://api.sbox.game/leaderboards/mygame/highscore",
                HttpMethod.Get,
                new Dictionary<string, string> { ["Authorization"] = $"Bearer {token}" });
            return scores;
        }
        catch (Exception ex)
        {
            Log.Error($"Failed to get scores: {ex.Message}");
            return Array.Empty<Score>();
        }
    }
}