Справочник по API

API SEO for Jobs позволяют Вам с легкостью интегрировать Google for Jobs и выйти за рамки базовой интеграции размещения вакансий из коробки.

Зарегистрируйтесь и запросите токен API здесь: https://app.seo-for-jobs.com/register

Корневой URL API - https://app.seo-for-jobs.com/api/public. Токен API для аутентификации можно запросить в Вашем аккаунте SEO for Jobs. Для использования API необходим активный пакет. Токен должен быть отправлен через дополнительный заголовок "x-api-token". Лимит запросов составляет 50 запросов в час и может быть увеличен по запросу.

GET /jobs

Получите список всех объявлений о работе в Вашем аккаунте.

Параметры:

нет

Ответ (пример):

{
list: [
{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur
.
.." ...
},
{...}
]
}

CURL (Пример):

$curl - XGET - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' 'https://app.seo-for-jobs.com/api/public/jobs'

POST /job

Создайте новую вакансию в своем аккаунте.

Параметры:

• статус: Один из вариантов "DRAFT" или "PUBLISHED".

• название: строка

• description: HTML-описание (допустимые теги: br, ul, li)

• employmentType: NULL или список "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (например: ["FULLTIME", "PARTTIME"]).

• salaryCurrency: NULL или одно из этих "EUR", "CHF", "INR", "JPY", "USD".

• salaryValue: Число (например: 42.00)

• salaryUnit: NULL или одно из этих "DAY", "HOUR", "WEEK", "YEAR", "MONTH".

• streetAndNo: String

• город: строка

• postalCode: Строка (из-за ведущих нулей)

• countryCode: i18n код страны (например, "DE" или "FR").

• название компании: строка

• companyLogoUrl: Полный URL-адрес логотипа (250px x 250px, .png, .jpeg, .jpg)

• redirectUrl: Полный URL для перенаправления после нажатия на кнопку "Apply Button" в Google for Jobs.

Ответ (пример):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6"
status: "PUBLISHED",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur
..."
...
}

CURL (Пример):

$curl - XPOST - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' - H "Content-type: application/json" - d '{status: "PUBLISHED",title: "SAP S/4HANA Senior Developer",description: "Lore Ipsum ...",employmentType: ["FULLTIME", "PARTTIME"],streetAndNo: "Jungfernstieg 47",city: "Hamburg",postalCode: "20354",countryCode: "DE",companyName: "SFJ",redirectUrl: "https://www.seo-for-jobs.com/de/jobs/sap-hana-senior-developer"}' 'https://app.seo-for-jobs.com/api/public/job'

PUT /job/{id}

Обновите существующее объявление о работе с соответствующим {id}. Будут обновлены только представленные параметры. Обновление будет автоматически отправлено в Google, если после процесса обновления статус будет "PUBLISHED".

Параметр:

• статус: Один из вариантов "DRAFT" или "PUBLISHED".

• название: строка

• description: HTML-описание (допустимые теги: br, ul, li)

• employmentType: NULL или список "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (например: ["FULLTIME", "PARTTIME"]).

• salaryCurrency: NULL или одно из этих "EUR", "CHF", "INR", "JPY", "USD".

• salaryValue: Число (например: 42.00)

• salaryUnit: NULL или одно из этих "DAY", "HOUR", "WEEK", "YEAR", "MONTH".

• streetAndNo: String

• город: строка

• postalCode: Строка (из-за ведущих нулей)

• countryCode: i18n код страны (например, "DE" или "FR").

• название компании: строка

• companyLogoUrl: Полный URL-адрес логотипа (250px x 250px, .png, .jpeg, .jpg)

• redirectUrl: Полный URL для перенаправления после нажатия на кнопку "Apply Button" в Google for Jobs.

Ответ (пример):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
status: "PUBLISHED",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur ...
"
...
}

CURL (Пример):

$curl - XPUT - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' - H "Content-type: application/json" - d '{title: "SAP S/4HANA Junior Developer",employmentType: ["FULLTIME"]}' 'https://app.seo-for-jobs.com/api/public/job/2fd59d17-14ea-4b86-a3d8-c3126db5fbc6'

DELETE /job/{id}

Удалите вакансию с соответствующего {id}.

Параметры:

нет

Ответ (пример):

{
status: "SUCCESS"
}

CURL (Пример):

curl - XDELETE - H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' 'https://app.seo-for-jobs.com/api/public/job/2fd59d17-14ea-4b86-a3d8-c3126db5fbc6'

Ошибки

Если при обработке Вашего запроса произошла ошибка, Вы получите один из следующих кодов:

API_TOKEN_INVALID
Предоставленный API Token не был найден в активной учетной записи. Учетная запись помечается как "активная", если она имеет активный пакет.

REQUEST_LIMIT_REACHED
Дневной лимит запросов достигнут. Ваш лимит запросов будет восстановлен в течение скользящего 24-часового окна.

UPGRADE_NECESSARY
Общее количество заданий со статусом "PUBLISHED" достигло предела Вашего пакета. Пожалуйста, обновите свой аккаунт, чтобы публиковать больше заданий.

ID_NOT_FOUND
Предоставленный ID для конкретной вакансии не был найден.