Direct Connect \ Social Link
1. Trigger the social network authentication
To link/unlink a social network the user has to login with that social network account first. To start the authentication you need to send the user to a specific URL called Direct Connect URL. You could for example place that URL on a hyperlink so that the user triggers the social network authentication when he clicks on the link.
Your must replace the following placeholders in the Direct Connect URL by your own values.
The subdomain of your OneAll site.
The key of the social network to link/unlink.
Example: twitter, facebook, linkedin, vimeo [...]
Required URL Parameters
You must add the following URL parameters to the Direct Connect URL.
|Required URL Parameter||Description|
The service to be used , must be
The url encoded link to the callback script on your server.
Whether to link (
Upon successful authentication the social network account will either be linked or unlinked depening upon the value of the
If you have specified a
user_token then the social network account will be un/linked from/to that token.
Optional URL parameters
There are a number of optional URL parameters can be added to the Direct Connect URL.
|Optional URL Parameter||Description|
Defines the permission scope to request from the social network.
Default: Compiled from the options that you have ticked in your OneAll account.
Sets the login data to be used, eg. the OpenID URL.
If you already have a user_token for the user, then it must be specified, otherwise leave it emtpy
user_token is a unique identifier that you receive from the OneAll API whenever a user connects with Social Login or links an account with Social Link.
If the user has never used Social Login or Social Link then you might not have a
user_token for that user yet.
In this case just leave the
user_token empty to have our API create a new token.
At the first use of Social Login or Social Link you must store the
user_token for that user in your database and specify it in any subsequent uses
of Social Link by the same user.
2. Retrieve the user's social network profile data
After the authentication the user is redirected to the specified
callback_uri to which the OneAll API adds the
callback_uri can fetch the status of the operation by sending a request with that token to the Read Connection Details
resource of the OneAll API.