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

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

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

https://app.seo-for-jobs.com/api/public. Корневой URL-адрес API - 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 (Пример):

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

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:https://www.seo-for-jobs.com/de/jobs/sap-hana-senior-developer"https://app.seo-for-jobs.com/api/public/job'"Lore Ipsum ...",employmentType: ["FULLTIME", "PARTTIME"],streetAndNo: "Jungfernstieg 47",city: "Hamburg",postalCode: "20354",countryCode: "DE",companyName: "SFJ",redirectUrl:"}' ' ;

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 (Пример):

https://app.seo-for-jobs.com/api/public/job/2fd59d17-14ea-4b86-a3d8-c3126db5fbc6'$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"]}' ' ;

DELETE /job/{id}

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

Параметр:

none

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



{ status: "SUCCESS" }

CURL (Пример):

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

Ошибки

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

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

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

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

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