ritmio-service.json

Request: Save user Basic Info 
Url: https://ritmio.com/api/users/:userId/profile 
Type: POST
Body: 
{
  "name" : "Juan Perez",
  "role": "influencer",
  "birthday" : "20/11/1983"
}
Response: 
{
  "message": "ok"
}

Request: Get user Basic Info 
Url: https://ritmio.com/api/users/:userId/profile 
Type: GET
Response: 
{
  "id": "1234567890"
  "name" : "Juan Perez",
  "role": "influencer",
  "birthday" : "20/11/1983"
}

Request: Save User Music Taste Info
Url: https://ritmio.com/api/users/:userId/taste 
Type: POST
Body: 
{
  "tags": [
    "latin",
    "pop",
    "classic"
  ]
}

Request Get User Music Taste Info
Url: https://ritmio.com/api/users/:userId/taste 
Type: GET
Response: 
{
  "tags": [
    "latin",
    "pop",
    "classic"
  ]
}


Request Get User Recomendations
Url: https://ritmio.com/api/users/:userId/recomendations
Type: GET
Response: 
[
  {
    "id": "1234",
    "name": "Cut To The Feeling",
    "artist": "Carly Rae Jepsen",
    "preview": "https://url-to-song-image",
    "platformSpecific": [
      {
        "spotify": {
          "external_urls": {
            "spotify": "https://open.spotify.com/track/11dFghVXANMlKmJXsNCbNl"
          },
          "href": "https://api.spotify.com/v1/tracks/11dFghVXANMlKmJXsNCbNl",
          "id": "11dFghVXANMlKmJXsNCbNl",
          "is_local": false,
          "popularity": 63,
          "preview_url": "https://p.scdn.co/mp3-preview/3eb16018c2a700240e9dfb8817b6f2d041f15eb1?cid=774b29d4f13844c495f206cafdad9c86",
          "track_number": 1,
          "type": "track",
          "uri": "spotify:track:11dFghVXANMlKmJXsNCbNl",
          "artists": [
            {
              "external_urls": {
                "spotify": "https://open.spotify.com/artist/6sFIWsNpZYqfjUpaCgueju"
              },
              "href": "https://api.spotify.com/v1/artists/6sFIWsNpZYqfjUpaCgueju",
              "id": "6sFIWsNpZYqfjUpaCgueju",
              "name": "Carly Rae Jepsen",
              "type": "artist",
              "uri": "spotify:artist:6sFIWsNpZYqfjUpaCgueju"
            }
          ]
        }
      },
      {
        "youtube": {
          "id": "youtube-song-id",
          "link": "https://youtube.com/path-to-song"
          -- more youtube info, not MVP
        }
      }
    ]
  }
]

Request Get User Liked songs
Url: https://ritmio.com/api/users/:userId/liked-songs
Type: GET
Response: 
[
  {
    "id": "1234",
    "name": "Cut To The Feeling",
    "artist": "Carly Rae Jepsen",
    "preview": "https://url-to-song-image",
    "platformSpecific": [
      {
        "spotify": {
          "external_urls": {
            "spotify": "https://open.spotify.com/track/11dFghVXANMlKmJXsNCbNl"
          },
          "href": "https://api.spotify.com/v1/tracks/11dFghVXANMlKmJXsNCbNl",
          "id": "11dFghVXANMlKmJXsNCbNl",
          "is_local": false,
          "popularity": 63,
          "preview_url": "https://p.scdn.co/mp3-preview/3eb16018c2a700240e9dfb8817b6f2d041f15eb1?cid=774b29d4f13844c495f206cafdad9c86",
          "track_number": 1,
          "type": "track",
          "uri": "spotify:track:11dFghVXANMlKmJXsNCbNl",
          "artists": [
            {
              "external_urls": {
                "spotify": "https://open.spotify.com/artist/6sFIWsNpZYqfjUpaCgueju"
              },
              "href": "https://api.spotify.com/v1/artists/6sFIWsNpZYqfjUpaCgueju",
              "id": "6sFIWsNpZYqfjUpaCgueju",
              "name": "Carly Rae Jepsen",
              "type": "artist",
              "uri": "spotify:artist:6sFIWsNpZYqfjUpaCgueju"
            }
          ]
        }
      },
      {
        "youtube": {
          "id": "youtube-song-id",
          "link": "https://youtube.com/path-to-song"
          -- more youtube info, not MVP
        }
      }
    ]
  }
]

Request Get User Music
Url: https://ritmio.com/api/users/:userId/self-songs
Type: GET
Response: 
[
  {
    "id": "1234",
    "name": "Cut To The Feeling",
    "artist": "Carly Rae Jepsen",
    "preview": "https://url-to-song-image",
    "platformSpecific": [
      {
        "spotify": {
          "external_urls": {
            "spotify": "https://open.spotify.com/track/11dFghVXANMlKmJXsNCbNl"
          },
          "href": "https://api.spotify.com/v1/tracks/11dFghVXANMlKmJXsNCbNl",
          "id": "11dFghVXANMlKmJXsNCbNl",
          "is_local": false,
          "popularity": 63,
          "preview_url": "https://p.scdn.co/mp3-preview/3eb16018c2a700240e9dfb8817b6f2d041f15eb1?cid=774b29d4f13844c495f206cafdad9c86",
          "track_number": 1,
          "type": "track",
          "uri": "spotify:track:11dFghVXANMlKmJXsNCbNl",
          "artists": [
            {
              "external_urls": {
                "spotify": "https://open.spotify.com/artist/6sFIWsNpZYqfjUpaCgueju"
              },
              "href": "https://api.spotify.com/v1/artists/6sFIWsNpZYqfjUpaCgueju",
              "id": "6sFIWsNpZYqfjUpaCgueju",
              "name": "Carly Rae Jepsen",
              "type": "artist",
              "uri": "spotify:artist:6sFIWsNpZYqfjUpaCgueju"
            }
          ]
        }
      },
      {
        "youtube": {
          "id": "youtube-song-id",
          "link": "https://youtube.com/path-to-song"
          -- more youtube info, not MVP
        }
      }
    ]
  }
]

users-microservice.json

Request: Register User
Url: https://ritmio.com/api/users/:userId/profile 
Type: POST
Body: 
{
  "spotifyToken" : "aldkjaslkdjlaskjdlaksjdajsldkjaslkdjlaksjd",
  "instagramToken": "bxvcnbxvcnbvxzncbvznxbcvbnzxnc"
}
Response: 
{
  "Name": "My Awesome Name on Instagram",
  "id": "123",
  "picture": "http://my_instagram_profile_picture_path",
  "birthday" : "20/11/1983",
"platformSpecificData": [
    {
      "spotify": {
        "country": "SE",
        "display_name": "Lucas Marino",
        "email": "email@example.com",
        "external_urls": {
          "spotify": "https://open.spotify.com/user/marinoluck"
        },
        "followers": {
          "href": null,
          "total": 3829
        },
        "href": "https://api.spotify.com/v1/users/marinoluck",
        "id": "wizzler",
        "images": [
          {
            "height": null,
            "url": "https://fbcdn-profile-a.akamaihd.net/hprofile-ak-frc3/t1.0-1/1970403_10152215092574354_1798272330_n.jpg",
            "width": null
          }
        ],
        "product": "premium",
        "type": "user",
        "uri": "spotify:user:marinoluck"
      }
    }
  ]
  
}