Zum Inhalt
HALOWERK

Laufwerk

browser task

Loads one https page in a real headless browser and performs up to eight steps on it: click, fill, select, check, uncheck, wait, wait_for_selector. Returns a per-step log saying what was attempted and whether it succeeded, plus the final URL, title, visible text, links, form structure and an optional screenshot as a base64 PNG. Three limits are part of the product, not accidents. robots.txt is fetched and evaluated before the page is loaded, following RFC 9309 precedence, and a disallowed.

POST https://lauf.halowerk.com/v1/browser-task

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
urlstringJaThe https page to load. Only public addresses; no credentials in the URL.
stepsarrayNeinAt most 8 steps, executed in order. A step cannot navigate to another address.
collectobjectNeinWhat to return. text and links are on by default.
viewportobjectNein
wait_untilstringNeinWhen the page counts as loaded.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The https page to load. Only public addresses; no credentials in the URL."
    },
    "steps": {
      "type": "array",
      "maxItems": 8,
      "description": "At most 8 steps, executed in order. A step cannot navigate to another address.",
      "items": {
        "type": "object",
        "required": [
          "action"
        ],
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "click",
              "fill",
              "select",
              "check",
              "uncheck",
              "wait",
              "wait_for_selector"
            ],
            "description": "What to do. \"press\" and free typing are deliberately absent — the Enter key is the usual way to submit a form without saying so."
          },
          "selector": {
            "type": "string",
            "maxLength": 300,
            "description": "CSS selector of the element. Required for click, fill, select, check, uncheck and wait_for_selector."
          },
          "text": {
            "type": "string",
            "maxLength": 2000,
            "description": "Text for fill."
          },
          "values": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "description": "Option values for select."
          },
          "ms": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000,
            "description": "Milliseconds for wait."
          },
          "wait_after_ms": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000,
            "description": "Pause after this step, e.g. to let a page settle."
          }
        }
      }
    },
    "collect": {
      "type": "object",
      "additionalProperties": false,
      "description": "What to return. text and links are on by default.",
      "properties": {
        "text": {
          "type": "boolean",
          "default": true
        },
        "links": {
          "type": "boolean",
          "default": true
        },
        "forms": {
          "type": "boolean",
          "default": false
        },
        "screenshot": {
          "type": "boolean",
          "default": false,
          "description": "A base64 PNG of the final state."
        },
        "console": {
          "type": "boolean",
          "default": false,
          "description": "Console messages emitted by the page."
        }
      }
    },
    "viewport": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "width": {
          "type": "integer",
          "minimum": 320,
          "maximum": 2560,
          "default": 1280
        },
        "height": {
          "type": "integer",
          "minimum": 320,
          "maximum": 2000,
          "default": 900
        }
      }
    },
    "wait_until": {
      "type": "string",
      "enum": [
        "load",
        "domcontentloaded",
        "networkidle"
      ],
      "default": "load",
      "description": "When the page counts as loaded."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "url": "https://example.com/",
  "steps": [
    {
      "action": "wait",
      "ms": 500
    }
  ],
  "collect": {
    "text": true,
    "links": true
  }
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →