API documentation Sharepool

Information about the integration of the Sharepool component.
With the Sharepool component, you can share high-quality candidate profiles with your customers as interactive web profiles. The key added value of this component is that you can share as many candidate profiles as you like with as many customers as you like using just one link.

Booth: 08/22

Introduction

The Sharepool API is designed according to the principles of REST set up. Several endpoints are available:

Create sharepool
Query sharepool
Update sharepool
Delete sharepool
Add candidate profile
Remove candidate profile
Get Sharepool link

All access is via HTTPS.

Important: We do not accept unsecured HTTP requests for security reasons. Only HTTPS requests are accepted.

Authentication

Each user of our API receives individual access data. If you are interested in integrating our service, please send us a short email to info@verlingo.de

API key

You simply specify these credentials as the API key via HTTP Authorization header.

HTTP-VERB: ("Authorization", IHR_API key)

HTTP Status-Codes

Below is a list of the most important HTTP status codes that the verlingo API outputs and how you can interpret them. In general, 200s codes stand for a successful request, 400s for an error in the request data (for example, a mandatory parameter is missing) and 500s for an error on our servers.

Code	Meaning
200 OK	A successful request
400 Bad Request	Is usually due to a syntax error in the request body
401 Unauthorized	Incorrect or missing authentication
404 Not Found	The resource could not be found
406 Not Acceptable	The format of the request is not supported
417 Expectation Failed	The information submitted is incorrect or incomplete
500, 502, 503 Server Error	Server error. Repeat the request after a short time and contact us if the error occurs permanently

Create sharepool

POSThttps://recruiting.verlingo.de/api/talentscout/v1/sharepool

Request / Inquiry

http-Header:

"Content-Type": "application/json"
"Authorization": IHR_API key

http-Body:

{
    "Title": "title",
    "Description": "description",
    "Logo": {
        "Format": "png | jpeg",
        "ImageB64": "base64"
    },
    "CandidatesAndVariants": [
        {
            "CandidateId": "candidateId",
            "VariantId": "variantId",
            "ExternalInfos": {
                Optional custom information as JSON
            }
        },
        …
    ],
    "Config": {
        "ContactFormMandatory": boolean (optional),
        "UseUserOfExternalUserId": boolean (optional)
    },
    "ExternalInfos": {
        "UserId": "userId (optional)",
        "Additional": {
            Optional custom information as JSON
        }
    }
}

If the 'Config.UseUserOfExternalUserId' attribute is set to true, the 'ExternalInfos.UserId' attribute must also be submitted and the action will then be performed under that user.

Response / Answer

You will always receive a response from our API in JSON format and HTTP status code 200 on a successful response.

{
    "SharepoolId": "sharepoolId",
    "Title": "title",
    "Description": "description",
    "CandidatesAndVariants": [
        {
            "CandidateId": "candidateId",
            "VariantId": "variantId",
            "Variant": {
                "VariantId": "variantId",
                "VariantName": "variantName",
                "CreatedAt": "2021-01-01T14:28:23.234Z",
                "CreatedBy": "createdBy",
                "UpdatedAt": "2021-01-01T14:28:23.234Z",
                "UpdatedBy": "updatedBy",
                "EditLink": "editLink"
            },
            "ExternalInfos": externalInfos
        },
        …
    ],
    "Active": boolean,
    "ContactFormMandatory": boolean,
    "ExternalInfos": externalInfos,
    "RemainingDaysUntilAutoDeactivation": 28,
    "DateOfAutoDeactivation": "2022-09-20",
    "CreatedAt": "2022-08-23T15:43:01.042Z",
    "UpdatedAt": "2022-08-23T15:43:01.042Z",
    "CreatedBy": "createdBy",
    "UpdatedBy": "updatedBy"
}

Query sharepool

GEThttps://recruiting.verlingo.de/api/talentscout/v1/sharepool

Request / Inquiry

http-Header:

"Content-Type": "application/json"
"Authorization": IHR_API key

http-Body:

{
    "SharepoolId": "sharepoolId"
}

Response / Answer

You will always receive a response from our API in JSON format and HTTP status code 200 on a successful response.

{
    "SharepoolId": "sharepoolId",
    "Title": "title",
    "Description": "description",
    "CandidatesAndVariants": [
        {
            "CandidateId": "candidateId",
            "VariantId": "variantId",
            "Variant": {
                "VariantId": "variantId",
                "VariantName": "variantName",
                "CreatedAt": "2021-01-01T14:28:23.234Z",
                "CreatedBy": "createdBy",
                "UpdatedAt": "2021-01-01T14:28:23.234Z",
                "UpdatedBy": "updatedBy",
                "EditLink": "editLink"
            },
            "ExternalInfos": externalInfos
        },
        …
    ],
    "Active": boolean,
    "ContactFormMandatory": boolean,
    "ExternalInfos": externalInfos,
    "RemainingDaysUntilAutoDeactivation": 28,
    "DateOfAutoDeactivation": "2022-09-20",
    "CreatedAt": "2022-08-23T15:43:01.042Z",
    "UpdatedAt": "2022-08-23T15:43:01.042Z",
    "CreatedBy": "createdBy",
    "UpdatedBy": "updatedBy"
}

Update sharepool

PUThttps://recruiting.verlingo.de/api/talentscout/v1/sharepool

Request / Inquiry

http-Header:

"Content-Type": "application/json"
"Authorization": IHR_API key

http-Body:

{
    "SharepoolId": "sharepoolId",
    "Title": "title",
    "Description": "description",
    "Logo": {
        "Format": "png | jpeg",
        "ImageB64": "base64"
    },
    "CandidatesAndVariants": [
        {
            "CandidateId": "candidateId",
            "VariantId": "variantId",
            "ExternalInfos": {
                Optional custom information as JSON
            }
        },
        …
    ],
    "Active": boolean,
    "Config": {
        "ContactFormMandatory": boolean,
        "UseUserOfExternalUserId": boolean
    },
    "ExternalInfos": {
        "UserId": "userId",
        "Additional": {
            Optional custom information as JSON
        }
    }
}

If the 'Config.UseUserOfExternalUserId' attribute is set to true, the 'ExternalInfos.UserId' attribute must also be submitted and the action will then be performed under that user.

You can pass only the information that should be updated.

Response / Answer

You will always receive a response from our API in JSON format and HTTP status code 200 on a successful response.

{
    "SharepoolId": "sharepoolId",
    "Title": "title",
    "Description": "description",
    "CandidatesAndVariants": [
        {
            "CandidateId": "candidateId",
            "VariantId": "variantId",
            "Variant": {
                "VariantId": "variantId",
                "VariantName": "variantName",
                "CreatedAt": "2021-01-01T14:28:23.234Z",
                "CreatedBy": "createdBy",
                "UpdatedAt": "2021-01-01T14:28:23.234Z",
                "UpdatedBy": "updatedBy",
                "EditLink": "editLink"
            },
            "ExternalInfos": externalInfos
        },
        …
    ],
    "Active": boolean,
    "ContactFormMandatory": boolean,
    "ExternalInfos": externalInfos,
    "RemainingDaysUntilAutoDeactivation": 28,
    "DateOfAutoDeactivation": "2022-09-20",
    "CreatedAt": "2022-08-23T15:43:01.042Z",
    "UpdatedAt": "2022-08-23T15:43:01.042Z",
    "CreatedBy": "createdBy",
    "UpdatedBy": "updatedBy"
}

Delete sharepool

DELETEhttps://recruiting.verlingo.de/api/talentscout/v1/sharepool

Request / Inquiry

http-Header:

"Content-Type": "application/json"
"Authorization": IHR_API key

http-Body:

{
    "SharepoolId": "sharepoolId",
    "Config": {
        "UseUserOfExternalUserId": boolean
    },
    "ExternalInfos": {
        "UserId": "userId"
    }
}

If the 'Config.UseUserOfExternalUserId' attribute is set to true, the 'ExternalInfos.UserId' attribute must also be submitted and the action will then be performed under that user.

Response / Answer

You will always receive a response from our API in JSON format and HTTP status code 200 on a successful response.

{
    "message": "Sharepool successfully deleted."
}

Add candidate profile

POSThttps://recruiting.verlingo.de/api/talentscout/v1/sharepool/candidatesandvariants

Request / Inquiry

http-Header:

"Content-Type": "application/json"
"Authorization": IHR_API key

http-Body:

{
    "SharepoolId": "sharepoolId",
    "AddCandidateId": "candidateId",
    "AddVariantId": "variantId",
    "AddExternalInfos": {
        Optional custom information as JSON
    },
    "Config": {
        "UseUserOfExternalUserId": boolean
    },
    "ExternalInfos": {
        "UserId": "userId"
    }
}

If the 'Config.UseUserOfExternalUserId' attribute is set to true, the 'ExternalInfos.UserId' attribute must also be submitted and the action will then be performed under that user.

Response / Answer

You will always receive a response from our API in JSON format and HTTP status code 200 on a successful response.

{
    "SharepoolId": "sharepoolId",
    "Title": "title",
    "Description": "description",
    "CandidatesAndVariants": [
        {
            "CandidateId": "candidateId",
            "VariantId": "variantId",
            "Variant": {
                "VariantId": "variantId",
                "VariantName": "variantName",
                "CreatedAt": "2021-01-01T14:28:23.234Z",
                "CreatedBy": "createdBy",
                "UpdatedAt": "2021-01-01T14:28:23.234Z",
                "UpdatedBy": "updatedBy",
                "EditLink": "editLink"
            },
            "ExternalInfos": externalInfos
        },
        …
    ],
    "Active": boolean,
    "ContactFormMandatory": boolean,
    "ExternalInfos": externalInfos,
    "RemainingDaysUntilAutoDeactivation": 28,
    "DateOfAutoDeactivation": "2022-09-20",
    "CreatedAt": "2022-08-23T15:43:01.042Z",
    "UpdatedAt": "2022-08-23T15:43:01.042Z",
    "CreatedBy": "createdBy",
    "UpdatedBy": "updatedBy"
}

Remove candidate profile

DELETEhttps://recruiting.verlingo.de/api/talentscout/v1/sharepool/candidatesandvariants

Request / Inquiry

http-Header:

"Content-Type": "application/json"
"Authorization": IHR_API key

http-Body:

{
    "SharepoolId": "sharepoolId",
    "RemoveCandidateId": "candidateId",
    "RemoveVariantId": "variantId",
    "Config": {
        "UseUserOfExternalUserId": boolean
    },
    "ExternalInfos": {
        "UserId": "userId"
    }
}

If the 'Config.UseUserOfExternalUserId' attribute is set to true, the 'ExternalInfos.UserId' attribute must also be submitted and the action will then be performed under that user.

Response / Answer

You will always receive a response from our API in JSON format and HTTP status code 200 on a successful response.

{
    "SharepoolId": "sharepoolId",
    "Title": "title",
    "Description": "description",
    "CandidatesAndVariants": [
        {
            "CandidateId": "candidateId",
            "VariantId": "variantId",
            "Variant": {
                "VariantId": "variantId",
                "VariantName": "variantName",
                "CreatedAt": "2021-01-01T14:28:23.234Z",
                "CreatedBy": "createdBy",
                "UpdatedAt": "2021-01-01T14:28:23.234Z",
                "UpdatedBy": "updatedBy",
                "EditLink": "editLink"
            },
            "ExternalInfos": externalInfos
        },
        …
    ],
    "Active": boolean,
    "ContactFormMandatory": boolean,
    "ExternalInfos": externalInfos,
    "RemainingDaysUntilAutoDeactivation": 28,
    "DateOfAutoDeactivation": "2022-09-20",
    "CreatedAt": "2022-08-23T15:43:01.042Z",
    "UpdatedAt": "2022-08-23T15:43:01.042Z",
    "CreatedBy": "createdBy",
    "UpdatedBy": "updatedBy"
}

Get Sharepool link

GEThttps://recruiting.verlingo.de/api/talentscout/v1/sharepool/link

Request / Inquiry

http-Header:

"Content-Type": "application/json"
"Authorization": IHR_API key

http-Body:

{
    "SharepoolId": "sharepoolId",
    "Customer": "customer",
    "Config": {
        "UseUserOfExternalUserId": boolean
    },
    "ExternalInfos": {
        "UserId": "userId"
    }
}

If the 'Config.UseUserOfExternalUserId' attribute is set to true, the 'ExternalInfos.UserId' attribute must also be submitted and the action will then be performed under that user.

The 'Customer' attribute is mandatory and is used to identify the recipient and track the actions performed by him/her.

Response / Answer

You will always receive a response from our API in JSON format and HTTP status code 200 on a successful response.

{
    "SharepoolId": "sharepoolId",
    "Active": boolean,
    "ContactFormMandatory": boolean,
    "RemainingDaysUntilAutoDeactivation": 28,
    "DateOfAutoDeactivation": "2022-09-20",
    "Customer": "customer",
    "CustomerLink": "customerLink",
    "PreviewLink": "previewLink"
}