Holdsport/SportMember API documentation

This readme describes the Holdsport/SportMember REST API.

Authentication

The API uses http basic authentication. If the username is demo and the password demo:

https://demo:[email protected]/v1/teams

You can use SportMember usernames and passwords as well.

If the user is managed by an admin you can use http basic authentication with the user id of the managed user and the password of the admin user.

Data format

JSON UTF-8 encoded strings.

The API

Teams

Getting the list of teams

Example

curl -u "demo:demo" -H "Accept: application/json" https://api.holdsport.dk/v1/teams

The result

[
    {
        "id": 6237, 
        "name": "frenke", 
        "primary_color": "", 
        "secondary_color": "",
        "role": 1
    }, 
...
    {
        "id": 7369, 
        "name": "Hurricanes", 
        "primary_color": "#ed2637", 
        "secondary_color": "#ffffff",
        "role": 2
    }
] 

Activities

Getting the list of activities

Example

curl -u "demo:demo" -H "Accept: application/json" https://api.holdsport.dk/v1/teams/6237/activities

The result

[
    {
        "comment": "", 
        "endtime": "", 
        "id": 256592, 
        "name": "Tur til Tyskland", 
        "pickup_place": "", 
        "pickup_time": "", 
        "place": "", 
        "starttime": "2012-01-13T01:00:00+01:00", 
        "status": "tilmeldt",
        "action_method": "PUT", 
        "action_path": "/v1/activities/256592/activities_users/2363897", 
        "actions": [],
        "no_rsvp_count": 3,
        "no_rsvp": [
            {
                "id": 148295, 
                "name": "Lars Christiansen"
            }, 
            {
                "id": 148288, 
                "name": "Lars J\u00f8rgensen"
            }, 
            {
                "id": 148293, 
                "name": "S\u00f8ren Knudsen"
            }
        ], 
    }, 
    {
        "comment": "", 
        "endtime": "", 
        "id": 256593, 
        "name": "Sverigestur", 
        "pickup_place": "", 
        "pickup_time": "", 
        "place": "", 
        "starttime": "2012-01-27T01:00:00+01:00", 
        "status": "ej tilkendegivet",
        "action_method": "POST", 
        "action_path": "/v1/activities/256593/activities_users", 
        "actions": [
            {
                "activities_user": {
                    "joined_status": 1, 
                    "name": "tilmeld", 
                    "picked": 1
                }
            }
        ],
        "no_rsvp_count": 1,
        "no_rsvp": [
            {
                "id": 148295, 
                "name": "Lars Christiansen"
            }
        ]
    },
    {
        "action_method": "POST",
        "action_path": "/v1/activities/653806/activities_coaches",
        "actions": [
            {
                "activities_coach": {
                    "name": "Attend"
                }
            }
        ],
        "activities_coaches": [],
        "activities_users": [],
        "club": "false",
        "comment": "",
        "comments": [],
        "department": false,
        "endtime": "",
        "id": 653806,
        "max_attendees": 36,
        "name": "Uden tr\u00e6nere",
        "no_rsvp": [
            {
                "id": 171725,
                "name": "Christian Poulsen"
            }
        ],
        "ride": true,
        "ride_comment": "We need 20 seats",
        "rides": [
            {
                "comment": "BMW",
                "id": 445,
                "seats": 3,
                "user_id": 177854,
                "firstname": "Rasmus",
                "lastname": "Hansen"
            }
        ],
        "show_ride_button": true
    }
]

The status value denotes the users current status with respect to the activity.

The actions arrays denotes the possible actions that the user can take with respect to this activity.

Pagination is done by adding a page and per_page parameter.

no_rsvp_count denotes the number of participants who haven't responded yet. no_rsvp is an array of the first 20 members who haven't responded yet.

Example

curl -u "demo:demo" https://api.holdsport.dk/v1/teams/7585/activities?page=2&per_page=10

Furthermore, a date parameter can be added to return activities from this day and onwards.

Example

curl -u "demo:demo" https://api.holdsport.dk/v1/teams/7585/activities?date=2012-01-1

The default for these parameters are page=1, per_page=20, and date = today.

Getting the details for a single activity

Example

curl -u "demo:demo" -H "Accept: application/json" https://api.holdsport.dk/v1/teams/6237/activities/256592

The result

{
    "comment": "", 
    "endtime": "", 
    "id": 256592, 
    "name": "Tur til Tyskland", 
    "pickup_place": "", 
    "pickup_time": "", 
    "place": "", 
    "starttime": "2012-01-13T01:00:00+01:00", 
    "status": "tilmeldt",
    "action_method": "PUT", 
    "action_path": "/v1/activities/256592/activities_users/2363897", 
    "actions": []
}

Change the user status (attending, unregistering, etc.)

The interesting part of the response is this

{
        "status": "ej tilkendegivet",
        "action_method": "POST", 
        "action_path": "/v1/activities/256593/activities_users", 
        "actions": [
            {
                "activities_user": {
                    "joined_status": 1, 
                    "name": "tilmeld", 
                    "picked": 1
                }
            }
        ]
}

status denotes the user's current status with the respect to the activity. actions is an array of the possible actions for the user. In the example one action is allowed (tilmeld (attend)) and the user status is changed to tilmeldt by performing an action_method (POST in the example) request to the action_path URL (/v1/activities/256593/activities_users in the example) with a json encoded version of

{
  "activities_user": {
                    "joined_status": 1, 
                    "picked": 1
                }
}

Or speaking curl:

curl -H "Content-Type: application/json" -X POST -u "demo:demo" https://api.holdsport.dk/v1/activities/256593/activities_users -d '{"activities_user": {"joined_status": 1, "picked": 1}}'

If the request was successful a HTTP status 201 (Created) is returned.

If there was an error a HTTP status 422 (Unprocessable Entity) is returned.

Activities with special requirements for coaches

Some activities have special requirements for coaches attending/unattending. Those activities will in addition to the lists of players attending also have a list of coaches attending ie. something like this:

  "activities_coaches": [
            {
                "name": "Martin Olsen",
                "updated_at": "2013-05-07T10:12:14+02:00",
                "user_id": 171716
            }
        ]

If it is an activity with special requirements for the coach, the action stuff will be along the lines

   "action_method": "POST",
   "action_path": "/v1/activities/653806/activities_coaches",
   "actions": [
         {
             "activities_coach": {
               "name": "Attend"
             }
         }
     ]

Note that the action path ends with activities_coaches (as opposed to activities_users).

Make the coach attend by performing the following request in curl

curl -H "Content-Type: application/json" -X POST -u "demo:demo" https://api.holdsport.dk/v1/activities/653806/activities_coaches  -d '{"activities_coach": {}}'

If the coach has the unattend option the action stuff will look something like this

   "action_method": "DELETE",
   "action_path": "/v1/activities/653806/activities_coaches/13",
   "actions": [
      {
         "activities_coach": {
             "name": "Unattend"
         }
      }
   ]

Note that the action_method is DELETE.

Make the coach unattend with the following curl request.

curl -H "Content-Type: application/json" -X DELETE -u "demo:demo" https://api.holdsport.dk/v1/activities/653806/activities_coaches/13

Getting the list of attendees for an activity

Example

curl -u "demo:demo" -H "Accept: application/json" https://api.holdsport.dk/v1/activities/256593/activities_users

The result

[
    {
        "id": 2363898, 
        "name": "Demo Demo", 
        "status": "tilmeldt", 
        "updated_at": "2011-12-21T14:03:42+01:00", 
        "user_id": 58856
    }
]

Adding a comment to an activity

Example

curl -H "Content-Type: application/json" -X POST -u "demo:demo" https://api.holdsport.dk/v1/activities/273260/comments -d '{"comment": {"body": "Testkommentar"}}'

Adding a ride to an activity

Example

curl -H "Content-Type: application/json" -X POST -u "demo:demo" https://api.holdsport.dk/v1/activities/273260/rides -d '{"ride": {"seats": 2, "comment": "BMW" }}'

Please note that the show_ride_button value for an activity should be true to be able to perform this action.

Removing a ride from an activity

Example

curl -H "Content-Type: application/json" -X DELETE -u "demo:demo" https://api.holdsport.dk/v1/activities/273260/rides/442

Getting the list of team members

Example

curl -u "demo:demo"  -H "Accept: application/json" https://api.holdsport.dk/v1/teams/7585/members

The result

[
  { "address" : " ",
    "email" : "[email protected]",
    "id" : 78776,
    "mobile" : "12345678",
    "name" : "Demo Demo",
    "profile_picture_path": "", 
    "role" : 2
  },
  { "address" : "8000 Aarhus",
    "email" : "[email protected]",
    "id" : 79413,
    "mobile" : "",
    "name" : "Kkk Kkkk"
    "profile_picture_path": "/media/BAhbB1sHOgZmSSI4MjAxMy8wg", 
    "role" : 1
  }
]

The role field can have five possible values 1 for player, 2 for coach, 3 for assistant coach, 4 for injured, and 5 for inactive.

The profile picture in the example can be fetched, by fetching the url

https://api.holdsport.dk/media/BAhbB1sHOgZmSSI4MjAxMy8wg

Getting a single team member

Example

curl -u "demo:demo"  -H "Accept: application/json" https://api.holdsport.dk/v1/teams/7585/members/78776

The result

{ "address" : " ",
"email" : "[email protected]",
"id" : 78776,
"mobile" : "12345678",
"name" : "Demo Demo",
"role" : 2
}

Getting the list of notes for the team

Example

curl -u "demo:demo"  -H "Accept: application/json" https://api.holdsport.dk/v1/teams/7585/notes

The result

[
    {
        "attachment_path": null, 
        "body": "Det gik rigtig godt i l\u00f8rdags :-)", 
        "created_at": "2013-01-06T23:30:38+01:00", 
        "created_by": "Ole Kristensen", 
        "title": "Kampreferat"
    }, 
    {
        "attachment_path": "/media/BAhbBlsHOgZmSSIpMjAxMy8wMS8wNy8xNV8xOF8yMV82NzNfVWRrbGlwXzIuSlBHBjoGRVQ/Udklip-2.JPG",
        "body": "Hver torsdag fra kl. 17 til 19.", 
        "created_at": "2013-01-06T23:30:38+01:00", 
        "created_by": "Ole Kristensen", 
        "title": "Tr\u00e6ningstider"
    }, 
]

The attachment in the example can be fetched, by fetching the url

https://api.holdsport.dk/media/BAhbBlsHOgZmSSIpMjAxMy8wMS8wNy8xNV8xOF8yMV82NzNfVWRrbGlwXzIuSlBHBjoGRVQ/Udklip-2.JPG

Getting the user profile

Example

curl -u "demo:demo"  -H "Accept: application/json" https://api.holdsport.dk/v1/user

Result

{
    "addresses": [
        {
            "city": "aarhus bj", 
            "email": "[email protected]", 
            "email_ex": "Hyl@h", 
            "mobile": "22775467", 
            "parents_name": "Jens Baggesen", 
            "postcode": "8000", 
            "street": "Dalga ", 
            "telephone": "80964"
        }, 
        {
            "city": "aarhus ", 
            "email": "[email protected]", 
            "email_ex": "Hyl@h ii. bi", 
            "mobile": "22775467", 
            "parents_name": "Jens Baggesen", 
            "postcode": "8000 b", 
            "street": "Dalga s", 
            "telephone": "80964666"
        }
    ], 
    "birthday": "1925-05-05", 
    "firstname": "Demo han", 
    "gender": "male",
    "age": 88,
    "id": 99464, 
    "lastname": "Danser Ye",
    "profile_picture_path": "/media/BAhbB1sHOgZmSSJDMjAxMy8wMy8wMS8wOV8wNF8zMF81OTdfU2NyZWVuX1Nob3RfMj"
}

Updating the user profile

Example

curl -H "Content-Type: application/json" -X PUT -u "demo:demo" https://api.holdsport.dk/v1/user -d '{"user": { "addresses": [{"street": "Sandageralle", "postcode": "8300", "city": "Odder", "mobile": "88888887", "email": "[email protected]"}], "firstname": "Demo", "lastname": "Demosen"}}'

A user may have one or two addresses each containing some of the following fields: street, city, postcode, telephone, mobile, email, email_ex, parents_name

You can upload a profile picture by using a standard Multipart form submit ie.

curl -X PUT -F "user[profile_picture][email protected]" -u "demo:demo" https://api.holdsport.dk/v1/user

Getting the list of profiles that this user is an admin for

Example

curl -u "demo:demo" -H "Accept: application/json" https://api.holdsport.dk/v1/profiles

Result

[
  { "address" : " ",
    "email" : "[email protected]",
    "id" : 78776,
    "mobile" : "12345678",
    "name" : "Demo Demo"
  },
  { "address" : "8000 Aarhus",
    "email" : "[email protected]",
    "id" : 79413,
    "mobile" : "",
    "name" : "Kkk Kkkk"
  }
]

The first profile returned is the profile of the admin. If there are no more profiles, the user is not an admin for other users.

To authenticate as the second user in the example you would use the user id (79413) and the password of the admin user (demo).

Example

curl -u "79413:demo" -H "Accept: application/json" https://api.holdsport.dk/v1/teams