Route

This resource provides Routes created by users as a list of links to Routes.

Resource URIs

Item URI: /v7.0/route_bookmark/{pk}/

Collection URI: /v7.0/route_bookmark/

Item

Item methods

GET Retrieve a Route by id
DELETE Delete a Route by id

route The route being bookmarked
user The user that created the bookmark

Collection

Collection methods

GET Retrieve several Routes
POST Create a Route

Collection query parameters

Name Description Type Required
user Specifies user to retrieve Routes for. string Yes

Collection properties

Name Description Type Units HTTP Support
total_count the total number of bookmarks that apply to the query. int   GET: Required

Embedded collections

route_bookmarks A collection of bookmarks with links as described under Item links

Pagination links available.

Usage

GET Route entity

Request GET: /v7.0/route_bookmark/{pk}/
Response: 200
{
  "_links": {
    "route": [
      {
        "href": "/v7.0/route/351989943/",
        "id": "351989943"
      }
    ], 
    "documentation": [
      {
        "href": "https://developer.underarmour.com/docs/"
      }
    ], 
    "self": [
      {
        "href": "/v7.0/route_bookmark/9911829/",
        "id": "9911829"
      }
    ], 
    "user": [
      {
        "href": "/v7.0/user/123456/",
        "id": "123456"
      }
    ]
  }, 
  "from_user": "/v7.0/user/123456/"
}

DELETE Route entity

Request DELETE: /v7.0/route_bookmark/{pk}/
Response: 204

GET Route collection

Request GET: /v7.0/route_bookmark/?user={user_id}
Response: 200
{
  "_embedded": {
    "route_bookmarks": [
      {
        "_links": {
          "route": [
            {
              "href": "/v7.0/route/351989943/",
              "id": "351989943"
            }
          ], 
          "self": [
            {
              "href": "/v7.0/route_bookmark/9911829/",
              "id": "9911829"
            }
          ], 
          "user": [
            {
              "href": "/v7.0/user/43334387/",
              "id": "43334387"
            }
          ]
        }, 
        "from_user": "/v7.0/user/{user_id}/"
      }
    ]
  }, 
  "total_count": 1
}

POST Route entity

Request POST: /v7.0/route_bookmark/
{
    "_links": {
        "route": [
            {
                "href": "/v7.0/route/86373519/",
                "id": "86373519"
            }
        ], 
        "user": [
            {
                "href": "/v7.0/user/123456/",
                "id": "123456"
            }
        ]
    }
}
Response: 201
{
  "_links": {
    "route": [
      {
        "href": "/v7.0/route/86373519/",
        "id": "86373519"
      }
    ], 
    "documentation": [
      {
        "href": "https://developer.underarmour.com/docs/"
      }
    ], 
    "self": [
      {
        "href": "/v7.0/route_bookmark/12713128/",
        "id": "12713128"
      }
    ], 
    "user": [
      {
        "href": "/v7.0/user/123456/",
        "id": "123456"
      }
    ]
  }, 
  "from_user": "/v7.0/user/123456/"
}