Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...


Tip

Available from CRM.COM R11.0.0


Excerpt

This method authenticates a subscriber against CRM.COM provisioned by AlphaNetworks Tucano system and returns a Json Web Token to indicate that the subscriber was authenticated successfully. 

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

access_token_identifier

(semi-optional)

Access Token Identifier

The identifier of the access token related with the subscription that should be returned as a result. The allowed access token identifier fields are the following:

Include Page
V4:access_token_identifier
V4:access_token_identifier

Tip

Deprecated from CRM.COM R18.0.0


customer_identification_medium_identifier

(semi-optional)

Customer Identification Medium Identifier

The identifier of the customer identification medium related with the subscription that should be returned as a result. The allowed customer identification medium identifier fields are the following

Include Page
V4:customer_identification_medium_identifier
V4:customer_identification_medium_identifier

Tip

Available from CRM.COM R18.0.0


installed_item_identifier

(semi-optional)

Installed Item Identifier

The identifier of the installed item related with the subscription that should be returned as a result. The allowed installed item identifier fields are the following:

Include Page
V4:installed_item_identifier
V4:installed_item_identifier

subscription_identifier

(semi-optional)

Subscription Identifier

The identifier of the subscription that should be returned as a result. The allowed subscription identifier fields are the following:

Include Page
V4:subscription_identifier
V4:subscription_identifier

subscription_type_identifier

(optional)

Subscription Type Identifier

The identifier of the type of subscription that should be returned as a result. The allowed subscription identifier fields are the following:

Include Page
V4:subscription_type_identifier
V4:subscription_type_identifier

This parameter is applicable only if the access token identifier is specified.

Tip

Available from CRM.COM R12.4.0


Restrictions

  • It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

Name

Type

Description

subscription_id

StringThe ID of the subscription as defined in CRM.COM
jwtJson Web Token

The Json Web Token used for authentication purposes.

The JWT header includes the following attributes: alg,typ

The JWT payload includes the following attributes: exp, userid, apip

Examples

Expand
titleExample 1

HTTP Method: POST

 


Request:

Body:

Code Block
languagejavascript
themeConfluencelanguagejavascript
linenumberstrue
{
    "token":"35108255345D4F98ABFD7810A08E432F",
    "subscription_identifier":{"number":"S0000000329"}
} 

Response:

Code Block
languagejavascript
themeConfluencelanguagejavascript
linenumberstrue
    {
        "data":
        {
            "subscription_id": "75E3E50139F24DC3A6C9AA0C026D0292",
            "jwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE0NzgyNTE5MzEsImlhdCI6MTQ3ODI1MTYzMSwidXNlcm5hbWUiOiJTMDAwMDAwMDMyOSJ9.FgRjJ6vuhRTP_0A1yFSxaRcaIugkJK5GyHbt1rRGxA0"
        },
        "status":
        {
            "code": "OK",
            "description": "",
            "message": ""
        }
    } 


...