feat: add canonical spot URLs

apps/api/app/main.py

@@ -135,6 +135,19 @@ def _spot_or_404(db: Session, spot_id: UUID) -> Spot:
     return spot
 
 
+@app.get("/api/v1/spots/resolve", response_model=SpotOut)
+def resolve_spot(
+    db: Db, waterbody: str, x: int = Query(ge=-10_000, le=10_000),
+    y: int = Query(ge=-10_000, le=10_000),
+) -> SpotOut:
+    spot = db.scalar(select(Spot).options(joinedload(Spot.waterbody)).join(Spot.waterbody).where(
+        Waterbody.slug == waterbody, Spot.x == x, Spot.y == y,
+    ))
+    if spot is None:
+        raise HTTPException(status_code=404, detail="spot not found")
+    return spot_detail(spot.id, db)
+
+
 @app.get("/api/v1/spots/{spot_id}", response_model=SpotOut)
 def spot_detail(spot_id: UUID, db: Db) -> SpotOut:
     spot = _spot_or_404(db, spot_id)

apps/api/tests/test_api.py

@@ -83,6 +83,9 @@ def test_spot_detail_and_catches() -> None:
     assert catches.status_code == 200
     assert len(catches.json()) == 3
     assert catches.json()[0]["source_system"] == "manual-import"
+    resolved = client.get("/api/v1/spots/resolve?waterbody=test-lake&x=10&y=20")
+    assert resolved.status_code == 200
+    assert resolved.json()["id"] == spot_id
 
 
 def test_records_list_is_empty_before_import() -> None: