Simple HTTP requests for complex browser actions

const API_BASE = new URL('https://api.browser.city/v1/do/');const apiKey = process.env.BROWSERCITY_API_KEY;async function doAction(action: string, body: unknown) {  const url = new URL(encodeURIComponent(action), API_BASE);  const response = await fetch(url, {    method: 'POST',    headers: {      Authorization: `Bearer ${apiKey}`,      'Content-Type': 'application/json',    },    body: JSON.stringify(body),  });  if (!response.ok) {    throw new Error(['Humanized REST action failed:', response.status].join(' '));  }  return response.json();}const session = await doAction('open', { browser: 'chromium' });try {  await doAction('navigate', { sessionId: session.result.sessionId, url: 'https://example.com' });  const markdown = await doAction('markdown', { sessionId: session.result.sessionId });  console.log(markdown.result.text);  const screenshot = await doAction('take_screenshot', {    sessionId: session.result.sessionId,    type: 'png',  });  const image = screenshot.artifacts?.find((artifact: { kind: string }) => artifact.kind === 'image');  console.log(image?.mediaType, image?.dataBase64.length);} finally {  await doAction('close', { sessionId: session.result.sessionId });}

import osfrom urllib.parse import quoteimport requestsAPI_BASE = 'https://api.browser.city/v1/do'HEADERS = {'Authorization': f"Bearer {os.environ['BROWSERCITY_API_KEY']}"}def action_url(action: str) -> str:    return f'{API_BASE}/{quote(action, safe="")}'def do_action(action: str, body: dict) -> dict:    response = requests.post(action_url(action), headers=HEADERS, json=body, timeout=30)    response.raise_for_status()    return response.json()session = do_action('open', {'browser': 'chromium'})try:    do_action('navigate', {'sessionId': session['result']['sessionId'], 'url': 'https://example.com'})    markdown = do_action('markdown', {'sessionId': session['result']['sessionId']})    print(markdown['result']['text'])finally:    do_action('close', {'sessionId': session['result']['sessionId']})

using System.Net.Http.Headers;using System.Net.Http.Json;var apiBase = new Uri("https://api.browser.city/v1/do/");using var http = new HttpClient();http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(    "Bearer", Environment.GetEnvironmentVariable("BROWSERCITY_API_KEY"));var session = await PostActionAsync<ActionResponse<OpenResult>>(http, apiBase, "open", new { browser = "chromium" });try{    await PostActionAsync<object>(http, apiBase, "navigate", new { sessionId = session.Result.SessionId, url = "https://example.com" });    var markdown = await PostActionAsync<MarkdownResponse>(http, apiBase, "markdown", new { sessionId = session.Result.SessionId });    Console.WriteLine(markdown.Result);}finally{    await PostActionAsync<object>(http, apiBase, "close", new { sessionId = session.Result.SessionId });}static Uri ActionUri(Uri apiBase, string action) =>    new(apiBase, Uri.EscapeDataString(action));static async Task<T> PostActionAsync<T>(HttpClient http, Uri apiBase, string action, object body){    using var response = await http.PostAsJsonAsync(ActionUri(apiBase, action), body);    response.EnsureSuccessStatusCode();    return await response.Content.ReadFromJsonAsync<T>()        ?? throw new InvalidOperationException("BrowserCity returned an empty response.");}record ActionResponse<T>(T Result, object? Context);record OpenResult(string SessionId);record MarkdownResponse(MarkdownResult Result);record MarkdownResult(string Text);

import com.fasterxml.jackson.databind.JsonNode;import com.fasterxml.jackson.databind.ObjectMapper;import java.net.URI;import java.net.URLEncoder;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.nio.charset.StandardCharsets;import java.util.Map;public class HumanizedRest {  private static final URI API_BASE = URI.create("https://api.browser.city/v1/do/");  private static final HttpClient HTTP = HttpClient.newHttpClient();  private static final ObjectMapper JSON = new ObjectMapper();  public static void main(String[] args) throws Exception {    var session = post("open", Map.of("browser", "chromium"));    var sessionId = session.path("result").path("sessionId").asText();    try {      post("navigate", Map.of("sessionId", sessionId, "url", "https://example.com"));      var markdown = post("markdown", Map.of("sessionId", sessionId));      System.out.println(markdown.path("result").path("text").asText());    } finally {      post("close", Map.of("sessionId", sessionId));    }  }  private static JsonNode post(String action, Map<String, ?> body) throws Exception {    var request = HttpRequest.newBuilder(actionUri(action))        .header("Authorization", "Bearer %s".formatted(System.getenv("BROWSERCITY_API_KEY")))        .header("Content-Type", "application/json")        .POST(HttpRequest.BodyPublishers.ofString(JSON.writeValueAsString(body)))        .build();    var response = HTTP.send(request, HttpResponse.BodyHandlers.ofString());    if (response.statusCode() / 100 != 2) {      throw new RuntimeException("Humanized REST action failed: %d %s".formatted(response.statusCode(), response.body()));    }    return JSON.readTree(response.body());  }  private static URI actionUri(String action) {    return API_BASE.resolve(URLEncoder.encode(action, StandardCharsets.UTF_8));  }}