Initialize application with social profile
Initialize application with social profile
The /applications/{applicationId}/import/{providerId} endpoint can be used to initialize an application with profile data from a social network (XING, linkedin). The applicant will be redirected to a website where to process the neccessary steps to import his profile. For information how to retrieve information about the available thirdparty providers, see the /thirdparties/import page.
By sending the following GET-request, one can obtain the requested redirect.
1 2 |
curl -i -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -X GET "https://api.softgarden.io/api/rest/v2/frontend/applications/{applicationId}/import/{providerId}?redirect_uri=https%3A%2F%2Fyour-frontend.com%2FSocialImportSuccessPage%3Faid%3D{applicationId}" |
with TOKEN being the user access token of the user in question. It is used to determine the validity of this request. Moreover the {applicationId} is the ID of the application to that the profile is imported and the {providerId} is the the thirdparty provider from which the profile is imported
.
Path parameters
Name | Description | Data Type |
---|---|---|
applicationId | The ID of the application to import the profile to. | String |
providerId | The ID of the thirdparty provider the profile is imported from. | String |
Query parameters
Name | Description | Data Type |
---|---|---|
redirect_uri | URI where the applicant should be redirected to after successful import | String |
Response values
Upon | Returned value | Description |
---|---|---|
success | redirect | The applicant is redirected to a website, where the importing process starts. |
failure | 500 – INTERNAL SERVER ERROR | When an error appears while processing your request. |
authorization error | 401 / 403 | See here for details. |