# adrs.is
# Permanent short links to exact geographic coordinates.
# Each {CODE} represents one schema.org/Place.
# Canonical machine access: .json suffix.

--------------------------------------------------

# Machine Spec — Version 1

BASE:
  https://adrs.is/{CODE}

JSON ACCESS:
  /{CODE}.json

PIN PROTECTED:
  /{CODE}_{PIN}.json

EXAMPLE:
  TRR + dad → /TRR_dad.json

RULES:
- Method: GET
- No cookies
- No session
- No form submission
- HTML parsing not required
- .json endpoint is authoritative

JSON CONTRACT:
Content-Type: application/json

{
  "@context": "https://schema.org",
  "@type": "Place",
  "name": string,
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": number,
    "longitude": number
  },
  "url": "https://adrs.is/{CODE}"
}

COORDINATES:
- WGS84
- Decimal degrees
- Numeric

ERRORS:
404 → code_not_found
403 → invalid_pin
Errors return JSON.

END