Middle-earth API

Report a sighting

POST/sightings

Reports an enemy sighting. Sightings of Nazgul are escalated automatically.

Request

Bodyapplication/json

  • id string

    Unique identifier.

  • creature string Required

    What was sighted.

    Allowed valuesorcuruk_haiwargnazgulbalrogtrolleagleent

  • location string Required

    Where it was seen.

  • count integer

    For large groups, estimates are fine: use 300 rather than counting.

    Default1

  • flying boolean

    Helps decide whether to alert the eagles. Not yet used for every creature.

  • seen_at string date-time

    When it was seen.

Example request

cURL
curl -X POST 'https://api.middle-earth.example/v3/sightings' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "string",
  "creature": "orc",
  "location": "string",
  "count": 1,
  "flying": true,
  "seen_at": "2024-01-01T00:00:00Z"
}'

Response

Sighting accepted for review.

Body

  • id string

    Unique identifier.

  • creature string Required

    What was sighted.

    Allowed valuesorcuruk_haiwargnazgulbalrogtrolleagleent

  • location string Required

    Where it was seen.

  • count integer

    For large groups, estimates are fine: use 300 rather than counting.

    Default1

  • flying boolean

    Helps decide whether to alert the eagles. Not yet used for every creature.

  • seen_at string date-time

    When it was seen.

Example response

application/json

Json
{
  "id": "string",
  "creature": "orc",
  "location": "string",
  "count": 1,
  "flying": true,
  "seen_at": "2024-01-01T00:00:00Z"
}