guide.climbers.appview.getRounds

gunnar.foo

Documentation

A climber's logged attempts, grouped into rounds. A round is an unbroken run of attempts within a timeframe sharing both route and wall angle.

main query

A climber's logged attempts, grouped into rounds. A round is an unbroken run of attempts within a timeframe sharing both route and wall angle.

Parameters

actor string at-identifier Required

The climber whose logbook to read.

cursor string Optional

No description available.

limit integer Optional

No description available.

maxDuration integer Optional

Longest a round may span, in seconds. Unbounded when omitted, so a round ends only when the route or the angle changes.

route string at-uri Optional

Narrow to one route. Every route is listed when it is omitted.

Output

Encodingapplication/json
cursor string Optional

No description available.

rounds array Required

No description available.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
The climber whose logbook to read.
Longest a round may span, in seconds. Unbounded when omitted, so a round ends only when the route or the angle changes.
Narrow to one route. Every route is listed when it is omitted.
View raw schema 
{
  "description": "A climber's logged attempts, grouped into rounds. A round is an unbroken run of attempts within a timeframe sharing both route and wall angle.",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "type": "string"
        },
        "rounds": {
          "items": {
            "ref": "#roundView",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "rounds"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "actor": {
        "description": "The climber whose logbook to read.",
        "format": "at-identifier",
        "type": "string"
      },
      "cursor": {
        "type": "string"
      },
      "limit": {
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "maxDuration": {
        "description": "Longest a round may span, in seconds. Unbounded when omitted, so a round ends only when the route or the angle changes.",
        "maximum": 86400,
        "minimum": 1,
        "type": "integer"
      },
      "route": {
        "description": "Narrow to one route. Every route is listed when it is omitted.",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "actor"
    ],
    "type": "params"
  },
  "type": "query"
}
attemptView object

One logged go, as it is stored in the climber's space.

Properties

note string Optional

Whatever the climber wants to remember about the go.

outcome string Required

What came of the go, as a token reference.

Known values: guide.climbers.dev.attempt#flash, guide.climbers.dev.attempt#send, guide.climbers.dev.attempt#top, guide.climbers.dev.attempt#attempt
uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema 
{
  "description": "One logged go, as it is stored in the climber's space.",
  "properties": {
    "note": {
      "description": "Whatever the climber wants to remember about the go.",
      "type": "string"
    },
    "outcome": {
      "description": "What came of the go, as a token reference.",
      "knownValues": [
        "guide.climbers.dev.attempt#flash",
        "guide.climbers.dev.attempt#send",
        "guide.climbers.dev.attempt#top",
        "guide.climbers.dev.attempt#attempt"
      ],
      "type": "string"
    },
    "uri": {
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "uri",
    "outcome"
  ],
  "type": "object"
}
roundView object

One unbroken run of attempts at one route.

Properties

angle integer Required

Wall angle the round was climbed at.

attempts array of ref#attemptView Required

The goes making up the round, in chronological order.

outcome string Required

What came of the go, as a token reference.

Known values: guide.climbers.dev.attempt#flash, guide.climbers.dev.attempt#send, guide.climbers.dev.attempt#top, guide.climbers.dev.attempt#attempt
startedAt string datetime Required

When the first attempt of the round was logged.

View raw schema 
{
  "description": "One unbroken run of attempts at one route.",
  "properties": {
    "angle": {
      "description": "Wall angle the round was climbed at.",
      "type": "integer"
    },
    "attempts": {
      "description": "The goes making up the round, in chronological order.",
      "items": {
        "ref": "#attemptView",
        "type": "ref"
      },
      "type": "array"
    },
    "outcome": {
      "description": "What came of the go, as a token reference.",
      "knownValues": [
        "guide.climbers.dev.attempt#flash",
        "guide.climbers.dev.attempt#send",
        "guide.climbers.dev.attempt#top",
        "guide.climbers.dev.attempt#attempt"
      ],
      "type": "string"
    },
    "route": {
      "ref": "guide.climbers.appview.getBoardRoutes#routeView",
      "type": "ref"
    },
    "startedAt": {
      "description": "When the first attempt of the round was logged.",
      "format": "datetime",
      "type": "string"
    },
    "wall": {
      "ref": "guide.climbers.appview.getWall#wallView",
      "type": "ref"
    }
  },
  "required": [
    "route",
    "startedAt",
    "angle",
    "outcome",
    "attempts"
  ],
  "type": "object"
}

Lexicon Garden

@