Propojení s vaším ATS | Vše pro firmy

Postavte si kariérní web nad nabídkami ze StartupJobs nebo importujte kandidáty do vlastního systému, oboje snadno zvládnete s naším API!

API je zdarma dostupné pro všechny firmy, které inzerují na StartupJobs.

Public API

Pokud máte zájem o vyzkoušení StartupJobs API, napište na support@startupjobs.cz.

1. Autorizace

Autorizace probíhá pomocí Bearer tokenu, který musí být posílán v hlavičce každého requestu na API endpointy. Každá firma obdrží unikátní token.

Authorization: Bearer <token>

2. Seznam nabídek

Endpoint vrací seznam aktivních nabídek firmy

Endpoint URL

GET

https://api.startupjobs.cz/company/offers

Query Parameters
```
none
```

Request example

https://api.startupjobs.cz/company/offers

Response
```
200 OK
```
Headers
```
Content-type: application/json
```

Body

[
    {
        "id": "9629f28d-78b5-4194-90f9-996cd6cf2aa9",
        "links": [
            {
                "url": "https://www.startupjobs.cz/nabidka/1234",
                "lang": "cs"
            },
            {
                "url": "https://www.startupjobs.cz/en/job/1234",
                "lang": "en"
            }
        ],
        "names": [
            {
                "name": "StartupJobs PHP žralok",
                "lang": "cs"
            },
            {
                "name": "StartupJobs PHP shark",
                "lang": "en"
            }
        ],
        "internal_name": "PHP programátor",
        "descriptions": [
            {
                "description": "<p>Pojď pracovat s námi! StartupJobs</p>",
                "lang": "cs"
            },
            {
                "description": "<p>Come work with us! StartupJobs</p>",
                "lang": "en"
            }
        ],
        "locations": [
            "Praha, Česko"
        ],
        "shifts": [
            {
                "name": "FULL_TIME",
                "hours": 160
            },
            {
                "name": "PART_TIME",
                "hours": 80
            }
        ],
        "collaborations": [
            {
                "id": 1,
                "collaboration": "external"
            },
            {
                "id": 2,
                "collaboration": "remote"
            },
            {
                "id": 3,
                "collaboration": "internship"
            }
        ],
        "seniorities": [
            {
                "id": 1,
                "seniority": "junior"
            }
        ],
        "areas": [
            {
                "id": 1,
                "area": "Vývoj"
            },
            {
                "id": 2,
                "area": "Back-End"
            },
            {
                "id": 4,
                "area": "PHP"
            }
        ],
        "salary": {
            "min": 50000,
            "max": 80000,
            "measure": "monthly",
            "currency": "CZK"
        },
        "benefits": [
            {
                "id": 1,
                "benefit": "13. a 14. plat"
            },
            {
                "id": 6,
                "benefit": "Čas na inovace"
            },
            {
                "id": 7,
                "benefit": "Čas na vlastní projekt"
            }
        ],
        "created_at": "2020-07-08T13:46:45",
        "updated_at": "2020-07-08T13:59:47",
        "valid_until": "2020-08-07T13:47:24"
    }
]

3. Seznam kandidátů

Endpoint vrací seznam všech kandidátů firmy

Endpoint URL

GET

https://api.startupjobs.cz/company/applications

Query Parameters

Request example

https://api.startupjobs.cz/company/applications?offer=1e8c1d7b-673a-42b6-9da9-5eeb2a8ce308&created_at.gt=2020-04-01&createad_at.lt=2020-05-01

Response
```
200 OK
```
Headers
```
Content-type: application/json
```

Body

[ 
   { 
     "id": "3e51e86d-9562-4611-a8a4-97412569f446", 
     "name": "Pan Žralok", 
     "created_at": "2020-07-08T13:56:43", 
     "offer": { 
         "id": "9629f28d-78b5-4194-90f9-996cd6cf2aa9", 
         "names": [ 
             { 
                 "name": "StartupJobs PHP zralok", 
                 "lang": "cs" 
              }, 
              { 
                 "name": "StartupJobs PHP shark", 
                 "lang": "en" 
              } 
          ], 
          "created_at": "2020-07-08T13:46:45"
     } 
  } 
]

4. Detail kandidáta

Endpoint vrací detailní informace o kandidátovi

Endpoint URL

GET

https://api.startupjobs.cz/company/applications/{candidate uuid}

Query Parameters
```
none
```

Request example

https://api.startupjobs.cz/company/applications/3e51e86d-9562-4611-a8a4-97412569f446

Response
```
200 OK
```
Headers
```
Content-type: application/json
```

Body

{
    "id": "5bf84a69-3a5c-4ddb-8cea-ae111bd262c5",
    "name": "Pan Žralok",
    "email": "zralok@startupjobs.cz",
    "phone": "123 456 789",
    "linkedin": {
        "url": "https://www.linkedin.com/panzralok"
    },
    "text": "Umím skvěle programovat v PHP!",
    "attachments": [
        {
            "url": "https://www.startupjobs.cz/uploads/panzralok.png"
        }
    ],
    "notes": null,
    "status": "new",
    "offer": {
        "id": "9629f28d-78b5-4194-90f9-996cd6cf2aa9",
        "name": [
            {
                "name": "StartupJobs PHP žralok",
                "lang": "cs"
            },
            {
                "name": "StartupJobs PHP shark",
                "lang": "en"
            }
        ],
        "internal_position_name": "PHP programátor"
    },
    "created_at": "2020-07-08T13:59:47"
}

5. Přihlášení k odběru nových nabídek

Endpoint umožňuje zaregistrovat e-maily uživatelů, kteří obdrží upozornění, jakmile firma přidá novou nabídku.

Máte zájem o využití tohoto endpointu? Kontaktujte prosím .support@startupjobs.cz

Webhooks

Na StartupJobs můžete využít webhooks pro získání informací o přihlášených zájemcích.

Jak webhook nastavit?

Při přidání/úpravě nabídky v sekci Další možnosti můžete zadat URL adresu (webhook), na kterou vám budeme zasílat informace o zájemcích ihned po jejich přihlášení.

Webhook musí vracet HTTP response code 200, 201, 202, 204 nebo 422, jinak webhook automaticky odmažeme.

2. JSON payload

Informace o zájemci posíláme ve formátu JSON.

{
    "date": "2017-09-11T18:19:15+02:00",
    "candidateID": 12345,
    "offerID": 1234,
    "name": "Pan Žralok",
    "position": "Vývojář webhooků",
    "why": "<p>Chci se stát vývojářem webhooků na StartupJobs.cz, protože mě to baví!</p>",
    "phone": "+420 725 875 752",
    "email": "dev@startupjobs.cz",
    "details": "https://www.startupjobs.cz/admin/company/zajemce/32437/pan-zralok?oid=1234",
    "linkedin": "https://linkedin.com/pan-zralok",
    "internalPositionName": "JOB1",
    "files": [
        "https://www.startupjobs.cz/download/file.pdf"
    ],
    "gdpr_accepted": true
}

3. Testovací payload

Při nastavení webhooku (přidání/úprava nabídky sekce Další možnosti) můžete poslat testovací request (simulace přihlášení kandidáta). Payload testovacího requestu obsahuje navíc hodnotu "test":true.

{
    "date": "2017-09-11T18:19:15+02:00",
    "candidateID": 12345,
    "offerID": 1234,
    "name": "Mr. Shark",
    "position": "Webhook developer",
    "why": "<p>Hello from StartupJobs. This is not a real candidate, just testing your webhook.</p>",
    "phone": "+420 725 875 752",
    "email": "dev@startupjobs.cz",
    "details": "https://www.startupjobs.cz/",
    "linkedin": "https://linkedin.com/",
    "internalPositionName": "JOB1",
    "files": [
        "https://www.startupjobs.cz/favicon.ico"
    ],
    "gdpr_accepted": true,
    "test": true
}

V případě dotazů nás neváhejte kontaktovat na support@startupjobs.cz.

Public API

Webhooks