Browser

A real browser on the business's own sites, the one the council uses and you can watch live on the stage. Answers are plain text, with controls numbered [N].

How to drive it

GET/businesses/{business}/browser

The actions, and which sites it may open.

Needs the browser scope.

Parameters

business integer, in path, required: The business id, from GET /businesses.

curl "https://helstify.com/api/v1/businesses/60/browser" \
  -H "Authorization: Bearer $HELSTIFY_KEY"

const res = await fetch("https://helstify.com/api/v1/businesses/60/browser", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.HELSTIFY_KEY}`,
  },
});
const data = await res.text();

import os, requests

res = requests.get(
    "https://helstify.com/api/v1/businesses/60/browser",
    headers={"Authorization": f"Bearer {os.environ['HELSTIFY_KEY']}"},
)
print(res.text)

Response200

POST this URL with do=<action> and its fields. Answers are plain text.
open url=<path or full URL> | look | click ref=N | type ref=N text=…
Allowed sites: northwind.coffee, shop.northwind.coffee

Act

POST/businesses/{business}/browser

do is one of open, look, click, type, select, scroll, back, reload, read, find, wait.

Needs the browser scope.

Parameters

business integer, in path, required: The business id, from GET /businesses.

Body

do string: For example open
url string: For example /contact

curl -X POST "https://helstify.com/api/v1/businesses/60/browser" \
  -H "Authorization: Bearer $HELSTIFY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"do":"open","url":"/contact"}'

const res = await fetch("https://helstify.com/api/v1/businesses/60/browser", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HELSTIFY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
      "do": "open",
      "url": "/contact"
  }),
});
const data = await res.text();

import os, requests

res = requests.post(
    "https://helstify.com/api/v1/businesses/60/browser",
    headers={"Authorization": f"Bearer {os.environ['HELSTIFY_KEY']}"},
    json={
        "do": "open",
        "url": "/contact"
    },
)
print(res.text)

Response200

Contact · Northwind Coffee — https://northwind.coffee/contact
[1] link "Home"
[2] textbox "Your email"
[3] button "Send"