API reference

Looking glass

Ping, traceroute and mtr run from each IP Transit location towards a public address or hostname. Open to anyone, a few runs a minute; signed-in callers get more.

The transit locations and what each can run

GET/v1/looking-glass

Dashboard session

The transit locations and what each can run.

Responses

200LookingGlass

Fields of LookingGlass

limitsLgLimitsrequired
How often one visitor may ask.
- at_onceintegerrequired
  Jobs not finished yet one visitor may have.
- per_hourintegerrequired
- per_minuteintegerrequired
locationsLgLocation[]required
- citystring | null
- countrystring | null
  ISO code: DE.
- idstringrequired
  The location's id, to aim a job at it.
- onlinebooleanrequired
  Whether its machine's loop is there to run a job now.
- toolsLgTool[]required
  What it can run.
signed_inbooleanrequired
Whether the caller is signed in, and gets the larger limits.

curl "https://api.infraflow.app/v1/looking-glass" \
  -b cookies.txt

Response · 200

{
  "limits": {
    "at_once": 1,
    "per_hour": 1,
    "per_minute": 1
  },
  "locations": [
    {
      "city": "string",
      "country": "string",
      "id": "string",
      "online": true,
      "tools": [
        "ping"
      ]
    }
  ],
  "signed_in": true
}

Run a ping, a traceroute or an mtr from a location

POST/v1/looking-glass/jobs

Dashboard session

Run a ping, a traceroute or an mtr from a location. Anyone may, a few times a minute; the job runs within a second or two and its output is polled with [job].

Request body · application/json

locationstringrequired
A location's id, from [LookingGlass].
targetstringrequired
A public IPv4 or IPv6 address, or a hostname.
toolLgToolrequired
What a machine runs, always with the same counts and timeouts: deploy/debian/ip-transit.sh says which.

Responses

A looking glass job and its output so far

GET/v1/looking-glass/jobs/{id}

Dashboard session

A looking glass job and its output so far. Its id is all it takes: it is random, and the job is forgotten after ten minutes.

Path parameters

iduuidpathrequired

Responses

200LgJob
404Problem

Fields of LgJob

addressstringrequired
The public address the machine aims at.
created_atdate-timerequired
exit_code

The transit locations and what each can run

GET/v1/looking-glass

Dashboard session

The transit locations and what each can run.

Responses

200LookingGlass

Fields of LookingGlass

limitsLgLimitsrequired
How often one visitor may ask.
- at_onceintegerrequired
  Jobs not finished yet one visitor may have.
- per_hourintegerrequired
- per_minuteintegerrequired
locationsLgLocation[]required
- citystring | null
- countrystring | null
  ISO code: DE.
- idstringrequired
  The location's id, to aim a job at it.
- onlinebooleanrequired
  Whether its machine's loop is there to run a job now.
- toolsLgTool[]required
  What it can run.
signed_inbooleanrequired
Whether the caller is signed in, and gets the larger limits.

curl "https://api.infraflow.app/v1/looking-glass" \
  -b cookies.txt

Response · 200

{
  "limits": {
    "at_once": 1,
    "per_hour": 1,
    "per_minute": 1
  },
  "locations": [
    {
      "city": "string",
      "country": "string",
      "id": "string",
      "online": true,
      "tools": [
        "ping"
      ]
    }
  ],
  "signed_in": true
}