SG Developers Initialize application with social profile
This endpoint is deprecated. Please do not use it for new projects. The documentation remains here for legacy API consumers.
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. |