POST ​/api​/v3​/stations​/follow

Follows the station passed via the id parameter.

Request

Example Request

{
  "auth_token": "abc1245920feab98ca",
  "id": 1
}

Example Parameters

  • auth_token: The user's auth_token obtained by calling the auth API.

    • Required: yes
    • Type: string
    • Example: abc1245920feab98ca
  • id: The station ID to follow

    • Required: yes
    • Type: integer
    • Example: 1

Response

Example Response

{
  "id": 1,
  "status": "following"
}

Response Parameters

  • id: The ID of the station followed

    • Required: yes
    • Type: integer
    • Example: 1
  • status: Will return 'following' on success.

    • Required: yes
    • Type: string
    • Example: following

Response Codes

Successful Response Codes

  • 200: Successful response.

Failure Response Codes

  • 401: Unauthorized request. Indicates a missing or invalid auth_token.

  • 404: The station with the given ID was not found

  • 400: The station ID passed was invalid. It should be a postitive integer.