POST ​/api​/v3​/account

Create a normal Deliradio user account.

Request

Example Request

{
  "referer_site": "http://www.google.com/",
  "account": {
    "username": "iceman",
    "email": "iceman@example.com",
    "password": "butterflywings",
    "remote_avatar_url": "http://example.com/ice_ice_baby.jpg",
    "avatar": null,
    "artist_profile": {
      "name": "The Rolling Stones",
      "facebook_url": "http://www.facebook.com/rollingstones",
      "location": {
        "id": {
        },
        "city": "Houston",
        "province": "TX",
        "country": "US",
        "lat": 29.763033,
        "lng": -95.363305
      },
      "genres": [
        "Rock"
      ],
      "url": "http://www.therollingstones.com/",
      "twitter_handle": "rollingstones",
      "bio": "Funky towns best ensemble"
    }
  }
}

Example Parameters

  • referer_site: The referer site from which the app is loaded

    • Required: no
    • Type: string
    • Example: http://www.google.com/
  • account: The account object containing account attributes.

    • Required: yes
    • username: The user's username that they use to log in.
      • Required: yes
      • Type: string
      • Example: iceman
    • email: The user's email address.
      • Required: yes
      • Type: string
      • Example: iceman@example.com
    • password: The user's password.
      • Required: yes
      • Type: string
      • Example: butterflywings
    • remoteavatarurl: URL to an avatar image. Ignored if avatar parameter is also passed.
      • Required: no
      • Type:
        • null
        • string
      • Example: http://example.com/iceicebaby.jpg
    • avatar: Avatar image file bytes. Takes precedence if remoteavatarurl parameter is also passed.
      • Required: no
      • Type:
        • null
        • file
    • artist_profile: Artist profile object containing the attributes for the artist profile. Used only for artist signup.

      • Required: no
      • name: The name of the artist
        • Required: yes
        • Type: string
        • Example: The Rolling Stones
      • facebook_url: The facebook url for the artist
        • Required: no
        • Type:
          • null
          • string
        • Example: http://www.facebook.com/rollingstones
      • location: The hometown location of the artist.

        • Required: no
        • id:

          • Required: no
          • Type: Integer
          • Example: 1
        • city:

          • Required: no
          • Type: string
          • Example: Houston
        • province:

          • Required: no
          • Type: string
          • Example: TX
        • country:

          • Required: no
          • Type: string
          • Example: US
        • lat:

          • Required: no
          • Type: number
          • Example: 29.763033
        • lng:

          • Required: no
          • Type: number
          • Example: -95.363305
      • genres: Genres associated with the artist

        • Required: no
        • Type: array
        • Items

          • Required: no
          • Type: string
          • Example: Rock
      • url: The URL to the artists website

        • Required: yes
        • Type:
          • null
          • string
        • Format: uri
        • Example: http://www.therollingstones.com/
      • twitter_handle: The twitter handle of the band

        • Required: yes
        • Type:
          • null
          • string
        • Example: rollingstones
      • bio: The artist biography

        • Required: yes
        • Type:
          • null
          • string
        • Example: Funky towns best ensemble

Response

Example Response

{
  "id": 185,
  "username": "iceman",
  "email": "iceman@example.com",
  "full_name": "Tom Kazansky",
  "bio": "You're everyone's problem. That's because every time you go up in the air, you're unsafe. I don't like you because you're dangerous.",
  "facebook_id": "iceman",
  "twitter_username": "iceman",
  "hometown": "Los Angeles, CA",
  "followers_count": 42,
  "following_count": 42,
  "lineup_count": 42,
  "shows_count": 42,
  "profile_type": "user",
  "follows_you": true,
  "you_follow": true,
  "email_preferences": [
    {
      "name": "help_email_notifications",
      "display_name": "Features and App Updates",
      "value": true
    }
  ],
  "avatar": {
    "small": "http://assets1.deliradio.com/assets/avatar_small.jpg",
    "large": "http://assets1.deliradio.com/assets/avatar_large.jpg"
  }
}

Response Parameters

  • id: The id of the user

    • Required: yes
    • Type: integer
    • Example: 185
  • username: The user's username that they use to log in.

    • Required: yes
    • Type: string
    • Example: iceman
  • email: The user's email address.

    • Required: yes
    • Type: string
    • Example: iceman@example.com
  • full_name: The user's full name.

    • Required: yes
    • Type:
      • null
      • string
    • Example: Tom Kazansky
  • bio: The user's bio.

    • Required: yes
    • Type:
      • null
      • string
    • Example: You're everyone's problem. That's because every time you go up in the air, you're unsafe. I don't like you because you're dangerous.
  • facebook_id: The user's Facebook id.

    • Required: no
    • Type:
      • null
      • string
    • Example: iceman
  • twitter_username: The user's Twitter username.

    • Required: no
    • Type:
      • null
      • string
    • Example: iceman
  • hometown: The user's hometown.

    • Required: yes
    • Type:
      • null
      • string
    • Example: Los Angeles, CA
  • followers_count: The count of accounts that follow this user.

    • Required: yes
    • Type: integer
    • Example: 42
  • following_count: The count of accounts that this user is following.

    • Required: yes
    • Type: integer
    • Example: 42
  • lineup_count: The count of upcoming shows in this user's lineup.

    • Required: yes
    • Type: integer
    • Example: 42
  • shows_count: The count of upcoming shows favorited by the user.

    • Required: yes
    • Type: integer
    • Example: 42
  • profile_type: The type of the account. Options 'user', 'band'

    • Required: yes
    • Type: string
    • Example: user
  • follows_you: Indicates whether or not the user follows the requesting account.

    • Required: yes
    • Type: boolean
    • Example: true
  • you_follow: Indicates whether or not the requesting account follows this user.

    • Required: yes
    • Type: boolean
    • Example: true
  • email_preferences: List of email preferences

    • Required: no
    • Type: array
    • Items

      • Required: no
      • name: Name of the email preference property
        • Required: no
        • Type: string
        • Example: helpemailnotifications
      • display_name: Display name of the email preference property
        • Required: no
        • Type: string
        • Example: Features and App Updates
      • value: Value of the email preference property
        • Required: no
        • Type: boolean
        • Example: true
  • avatar: ???

    • Required: yes
    • small: The small avatar, to be used in lists. Retina artwork will be provided if the DELI-RETINA header is sent.
      • Required: yes
      • Type: string
      • Format: uri
      • Example: http://assets1.deliradio.com/assets/avatar_small.jpg
    • large: The large avatar, to be used in lists. Retina artwork will be provided if the DELI-RETINA header is sent.
      • Required: yes
      • Type: string
      • Format: uri
      • Example: http://assets1.deliradio.com/assets/avatar_large.jpg

Response Codes

Successful Response Codes

  • 201: A valid response

Failure Response Codes

  • 422: Indicates a bad request including validation errors.