sso

Configure additional user settings

Adds more information to the user, such as bio, notification settings, and email

get/sso/v1/register-user

Request

  • Base URL
    https://www.spot.im/api
  • URL
    https://www.spot.im/api/sso/v1/register-user
  • Auth
    none declared. Required headers: Content-Type

Query parameters

access_tokenstring required

Secret access token provide by OpenWeb

code_astring required

Session ID returned after initiating an SSO session

display_namestring required

Non-unique personal identifier used prominently throughout the platform

A display name has the following characteristics:

  • Cannot exceed 30 characters
  • Is comprised of a combination of letters, numbers, special characters, or spaces

When not provided, OpenWeb creates a display name from the user_name.

If neither a username nor a display name is provided, the handshake will fail.

primary_keystring required

Unique user ID generated by a Partner’s backend user management system

user_namestring required

Unique personal identifier used to differentiate between different users

A username has the following characteristics:

  • Is greater than 3 characters, but less than 30 characters
  • Can be comprised of foreign-language characters
  • Cannot be comprised of delimiters, such as spaces, tabs, and other ASCII delimiters (/t, /r, and /n)
  • Cannot be comprised of special characters, such as < and >
  • Is preceded by the @ symbol when displayed

If a username is already taken, OpenWeb appends random letters or numbers to generate a unique version of that username and registers it to the user.

If a username is not provided, OpenWeb creates a username from the display_name, appends random letters or numbers to generate a unique version of that username, and registers it to the user.

If neither a username nor a display name is provided, the handshake will fail.

emailstring

Email of the user

email_verifiedboolean

Indicates that the email of the user has been verified by the user

Possible Values:

  • false (default)
  • true

OpenWeb only sends email notifications to verified email addresses.

image_urlstring

URL of the profile image of the user

This image is the avatar used for all comments created by the user. If the image_url is not set, OpenWeb selects a random avatar from the avatar scheme for the user.

To delete a set user image, send an empty string for this parameter.

locationstring

Location of the user

private_profileboolean

Indicates whether the user's commenting history and profile can be viewed by others

Possible Values:

  • false (default)
  • true
user_metadatastring

Indicates if the user is a subscriber or not and enables the segmentation of data by subscribers and non-subscribers

If a user's subscriber status changes, you must <a href="https://developers.openweb.com/docs/implement-single-sign-on#log-out-a-user" target="_blank">log out the user</a> and complete a new SSO flow. This ensures that a user's previous cached client state for user_metadata.is_subscriber is not used.

Possible Values (values must be Base64-encoded):

{
  "is_subscriber": true
}

When this value is passed for a user, you can also show a customized subscriber badge next to the user's name in the Conversation. Please contact Support to enable and customize the subscriber badge.

<hr />
{
  "is_subscriber": false
}

Headers

Content-Type'application/json' required

Enables sending a JSON body with the request

Request body

biostring

User bio

When configuring a user bio, the bio cannot exceed 200 characters.

This property can be passed with or without the role or settings object.

role'admin' | 'community-moderator' | 'journalist' | 'moderator' | 'registered' | 'viewer'

Permission level of the user

Possible values

  • admin: Access to all sections of the system
  • community-moderator: Ability to moderate comments within a Conversation, but no Admin Panel access
  • journalist: Ability to select top comments, but no Admin Panel access
  • moderator: Access only to the moderation section
  • registered: Regular user with no assigned role (This is the default permission that is set when no role is specified.)
  • viewer: View-only access to the moderation section

This property can be passed with or without the bio or settings object.

Response

string required

Success response returned after OpenWeb logs in the user

Changes