Справочник по 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

Получите список всех вакансий, размещенных в Вашем аккаунте.

Параметры:

none

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

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

CURL (Пример):

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

POST /job

Создайте новое объявление о работе в Вашей учетной записи.

Параметры:

• статус: Одно из следующих значений: "ПРОЕКТ" или "ПУБЛИКУЕТСЯ".

• заголовок: Строка

• описание: 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

• город: String

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

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

• companyName: Строка

• 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 amet
consetetur ..."
...
}

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: "Amelungstraße 8",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".

Параметр:

• статус: Одно из этих значений "ПРОЕКТ" или "ПУБЛИКУЕТСЯ".

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

• описание: 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

• город: String

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

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

• companyName: Строка

• 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 amet
consetetur ..."
...
}

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}.

Параметр:

none

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

{
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-токен не был найден в активном аккаунте. Аккаунт помечается как "активный", если у него есть активный пакет.

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

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

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