# Документация API ## Навыки ### Популярные навыки `https://guild.craft-group.xyz/api/skills/skills-on-main-page`
Чтобы получить популярные навыки нужно сделать GET запрос на URL https://guild.craft-group.xyz/api/skills/skills-on-main-page
## Профиль ### Список `https://guild.craft-group.xyz/api/profile`Для получения списка профилей необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/profile
Возможные параметры:
Параметры | Значение |
---|---|
limit | Количество профилей, которое вернет сервер при запросе. |
offset | Количество записей на которое нужно отступить в списке профилей. |
skills | Идентификаторы навыков по которым нужно отфильтровать профили. |
Пример запроса:
`https://guild.craft-group.xyz/api/profile?limit=5&offset=5&skills=1,2`
Возвращает массив объектов Профилей.
Каждый объект Профиля имеет такой вид:
Для того, чтобы получить данные одной записи необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/profile/{id} , где id это идентификатор профиля.
Пример запроса:
`https://guild.craft-group.xyz/api/profile/6`
Возвращает объект Профиля.
Как выглядит можно посмотреть выше.
Для того, отправить приглашение профилю на собеседование, необходимо сделать POST запрос на URL https://guild.craft-group.xyz/api/profile/add-to-interview
Возможные параметры:
Параметры | Значение |
---|---|
email* | Почта пользователя, который хочет пригласить на собеседование. |
profile_id* | Идентификатор профиля. |
phone | Телефон. |
comment | Дополнительные пожелания по собеседованию. |
Для получения списка отчетов необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/reports
Возможные параметры:
Параметры | Значение |
---|---|
fromDate* | Дата (yyyy-mm-dd) начала поиска отчетов. |
toDate | Дата (yyyy-mm-dd) окончания поиска отчетов. |
limit | Количество отчетов, которое вернет сервер при запросе (по умолчанию 10). |
offset | Количество записей на которое нужно отступить в списке отчетов. |
user_id | Идентификатор карточки пользователя отчета. |
Пример запроса:
`https://guild.craft-group.xyz/api/reports/index?fromDate=2021-08-01&toDate=2021-08-31&user_id=2limit=3&offset=2` ### Один отчет `https://guild.craft-group.xyz/api/reports/{id}`Для получения отчета необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/reports/{id}
Параметры:
Параметры | Значение |
---|---|
id* | ID отчета. |
Пример запроса на просмотр отчета с ID 13:
`https://guild.craft-group.xyz/api/reports/13` ### Создать отчет `https://guild.craft-group.xyz/api/reports/create`Для того, отправить приглашение профилю на собеседование, необходимо сделать POST запрос на URL https://guild.craft-group.xyz/api/reports/create
Возможные параметры:
Параметры | Значение |
---|---|
created_at* | Дата (yyyy-mm-dd) создания. |
user_card_id* | Идентификатор карточки пользователя. |
tasks* |
JSON массив содержащий объекты задач
[{ "task" : "Рефакторинг", "created_at": 1638260728, "status": 1, "minutes_spent": 26, "hours_spent" : 3 }] |
difficulties | Сложности. |
tomorrow | Планы на завтра. |
status | Номер статуса. |
Для удаления отчета необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/reports/delete
Возможные параметры:
Параметры | Значение |
---|---|
id* | Идентификатор отчета. |
Пример запроса:
`https://guild.craft-group.xyz/api/reports/delete?id=17` ### Обновить отчет `https://guild.craft-group.xyz/api/reports/update`Для удаления отчета необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/reports/update
Возможные параметры:
Параметры | Значение |
---|---|
id* | Идентификатор отчета. |
created_at | Дата (yyyy-mm-dd) создания. |
today | Сделанное сегодня. |
difficulties | Сложности. |
tomorrow | Планы на завтра. |
status | Номер статуса. |
Пример запроса:
`https://guild.craft-group.xyz/api/reports/update?id=18&created_at=2021-09-17&today=0&difficulties=diff&tomorrow=new task&status=1` ## Анкеты ###Список анкет `https://guild.craft-group.xyz/api/user-questionnaire/questionnaires-list`Для получения списка анкет необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/user-questionnaire/questionnaires-list
Требуемые параметры запроса:
Параметры | Значение |
---|---|
user_id | ID пользователя(int) |
Пример запроса:
`https://guild.craft-group.xyz/api/user-questionnaire/questionnaires-list?user_id=1`
Возвращает массив объектов записи Назначенная анкета.
Каждый объектимеет такой вид:
Передаваемые параметры объекта вопроса:
Параметры | Значение |
---|---|
user_id | ID пользователя(int) |
score | Полученные балы(int) |
percent_correct_answers | Процент правильных ответов(float) |
Если пользователь не найден или у пользователя нет активных анкет будет отправлено следующее сообщение:
```json5 { "name": "Not Found", "message": "Active questionnaire not found", "code": 0, "status": 404, "type": "yii\\web\\NotFoundHttpException" } ``` ### Вопросы анкеты `https://guild.craft-group.xyz/api/question/get-questions`Для получения вопросов анкеты необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/question/get-questions
Требуемые параметры запроса:
Параметры | Значение |
---|---|
uuid | UUID анкеты назначеной пользователю |
Пример запроса:
`https://guild.craft-group.xyz/api/question/get-questions?uuid=d222f858-60fd-47fb-8731-dc9d5fc384c5`
Возвращает массив объектов Вопросов.
Каждый объект Вопрос имеет такой вид:
Передаваемые параметры объекта вопроса:
Параметры | Значение |
---|---|
id | ID вопроса(int) |
question_type_id | ID типа вопроса(int) |
question_body | Вопрос(string) |
question_priority | Приоритет вопроса(int)(не используется) |
next_question | Следующий вопрос(int)(не используется) |
time_limit | Ограничение времени на ответ(time) |
Если вопрос не найден или не предпологает передачу ответов будет отправлено следующее сообщение:
```json5 { "name": "Not Found", "message": "Questions not found", "code": 0, "status": 404, "type": "yii\\web\\NotFoundHttpException" } ``` ### Ответы на вопрос `https://guild.craft-group.xyz/api/answer/get-answers`Для получения вариантов ответов на вопрос анкеты нужно сделать GET запрос на URL https://guild.craft-group.xyz/api/answer/get-answers
Требуемые параметры:
Параметры | Значение |
---|---|
question_id | ID вопроса |
Пример запроса:
`https://guild.craft-group.xyz/api/answer/get-answers?question_id=7`
Возвращает массив объектов Ответов.
Каждый объект Ответа имеет такой вид:
Передаваемые параметры объекта вопроса:
Параметры | Значение |
---|---|
id | ID вопроса(int) |
question_id | ID вопроса(int) |
answer_body | Ответ(string) |
Если ответы не найдены или вопрос не предпологает их наличие(открытый вопрос) будет отправлено следующее сообщение:
```json5 { "name": "Not Found", "message": "Answer not found or question inactive", "code": 0, "status": 404, "type": "yii\\web\\NotFoundHttpException" } ``` ### Один ответ пользователя `https://guild.craft-group.xyz/api/user-response/set-response`Для добавления ответа на вопрос от пользователя необходимо сделать POST запрос на URL https://guild.craft-group.xyz/api/user-response/set-response
Тело запроса содержит:
Параметры | Значение |
---|---|
user_id | ID пользователя |
question_id | ID вопроса(int) |
response_body | Ответ пользователя(string 255) |
user_questionnaire_uuid | UUID анкеты назначенной пользователю(string 36) |
Пример тела запроса:
```json5 { "user_id": "1", "question_id": "7", "response_body": "oooooooooooo111111111", "user_questionnaire_uuid": "d222f858-60fd-47fb-8731-dc9d5fc384c5" } ``` `https://guild.craft-group.xyz/api/user-response/set-response`
Возвращает объект Ответа.
Объект Ответа имеет такой вид:
Ответ содержит:
Параметры | Значение |
---|---|
user_id | ID пользователя |
question_id | ID вопроса(int) |
response_body | Ответ пользователя(string 255) |
user_questionnaire_uuid | UUID анкеты назначенной пользователю(string 36) |
answer_flag | Флаг ответа(1 - верно, 0 - ложно) |
В случаии ошибки в запросе будет отправлено сообщение следующего вида:
```json5 { "name": "Bad Request", "message": "{\"question_id\":[\"\В\о\п\р\о\с is invalid.\"]}", "code": 0, "status": 400, "type": "yii\\web\\BadRequestHttpException" } ``` ### Массив ответов пользователя `https://guild.craft-group.xyz/api/user-response/set-responses`Для добавления массива ответов на вопросы от пользователя необходимо сделать POST запрос на URL https://guild.craft-group.xyz/api/user-response/set-responses
Тело запроса содержит JSON c массивом ответов со следующими параметрами:
Параметры | Значение |
---|---|
user_id | ID пользователя |
question_id | ID вопроса(int) |
response_body | Ответ пользователя(string 255) |
user_questionnaire_uuid | UUID анкеты назначенной пользователю(string 36) |
Пример тела запроса:
```json5 { "userResponses": [ { "user_id": "1", "question_id": "7", "response_body": "oooooooooooo111111111", "user_questionnaire_uuid": "d222f858-60fd-47fb-8731-dc9d5fc384c5" }, { "user_id": "1", "question_id": "4", "response_body": "oooooooooooo2222222", "user_questionnaire_uuid": "d222f858-60fd-47fb-8731-dc9d5fc384c5" } ] } ```
Возвращает массив объектов ОтветПользователя.
Пример:
Ответ содержит:
Параметры | Значение |
---|---|
user_id | ID пользователя |
question_id | ID вопроса(int) |
response_body | Ответ пользователя(string 255) |
user_questionnaire_uuid | UUID анкеты назначенной пользователю(string 36) |
answer_flag | Флаг ответа(1 - верно, 0 - ложно) |
В случаии ошибки в запросе будет отправлено сообщение следующего вида:
```json5 { "name": "Bad Request", "message": "{\"question_id\":[\"\В\о\п\р\о\с is invalid.\"]}", "code": 0, "status": 400, "type": "yii\\web\\BadRequestHttpException" } ``` ## Менеджер ### Список менеджеров `https://guild.craft-group.xyz/api/manager/get-manager-list`Для получения списка менеджеров необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/manager/get-manager-list
Пример запроса:
`https://guild.craft-group.xyz/api/manager/get-manager?manager_id=1`
Возвращает список объектов Менеджера.
Пример ответа:
Передаваемые параметры объекта Менеджер:
Параметры | Значение |
---|---|
id | ID менеджера(int) |
fio | ФИО пользователя(varchar(255)) |
Почтовый адрес(string) |
Если менеджеры не найдены будет отправлено следующее сообщение:
```json5 { "name": "Not Found", "message": "Managers are not assigned", "code": 0, "status": 404, "type": "yii\\web\\NotFoundHttpException" } ``` ### Список работников менеджера `https://guild.craft-group.xyz/api/manager/get-employees-manager`Для получения списка сотрудников менеджера необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/manager/get-employees-manager
Требуемые параметры:
Параметры | Значение |
---|---|
manager_id | ID менеджера |
Пример запроса:
`https://guild.craft-group.xyz/api/manager/get-employees-manager?manager_id=3`
Возвращает список объектов Пользователь.
Ответ имеет такой вид:
Передаваемые параметры объекта Менеджер:
Параметры | Значение |
---|---|
id | ID пользователя(работника) у менеджера(int) |
fio | ФИО сотрудника(varchar(255)) |
Почтовый адрес(string) |
Если менеджер не найден или у него нет сотрудников будет отправлено следующее сообщение:
```json5 { "name": "Not Found", "message": "Managers are not assigned or employees are not assigned to him", "code": 0, "status": 404, "type": "yii\\web\\NotFoundHttpException" } ``` ### Данные менеджера `https://guild.craft-group.xyz/api/manager/get-manager`Для получения данных менеджера необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/manager/get-manager
Требуемые параметры:
Параметры | Значение |
---|---|
manager_id | ID менеджера |
Пример запроса:
`https://guild.craft-group.xyz/api/manager/get-manager?manager_id=1`
Возвращает объект Менеджера.
Каждый объект Менеджер имеет такой вид:
Передаваемые параметры объекта Менеджер:
Параметры | Значение |
---|---|
id | ID пользователя(работника) у менеджера(int) |
fio | ФИО сотрудника(varchar(255)) |
Почтовый адрес(string) |
Если менеджер не найден будет отправлено следующее сообщение:
```json5 { "name": "Not Found", "message": "Incorrect manager ID", "code": 0, "status": 404, "type": "yii\\web\\NotFoundHttpException" } ``` ## Задачи ### Задача `https://guild.craft-group.xyz/api/task/get-task`Для получения данных задачи необходимо отправить GET запрос на URL https://guild.craft-group.xyz/task/get-task
Требуемые параметры:
Параметры | Значение |
---|---|
task_id | ID менеджера |
Пример запроса:
`https://guild.craft-group.xyz/api/task/get-task?task_id=3`
Возвращает объект Задачи.
Каждый объект Задачи имеет такой вид:
Передаваемые параметры объекта Задача:
Параметры | Значение |
---|---|
id | ID задачи(int) |
project_id | ID проекта(int) |
title | Название задачи(string) |
status | Статус(int) |
created_at | Дата создания(string) |
updated_at | Дата изменения(string) |
user_id | ID наблюдателя проекта(int) |
description | Описание задачи(string) |
user_id_creator | ID создателя задачи(int) |
Если задача не найдена будет отправлено следующее сообщение:
```json5 { "name": "Not Found", "message": "The task does not exist", "code": 0, "status": 404, "type": "yii\\web\\NotFoundHttpException" } ``` ### Список задач `https://guild.craft-group.xyz/api/task/get-task-list`Для получения списка данных задач необходимо отправить GET запрос на URL https://guild.craft-group.xyz/task/get-task-list
Требуемые параметры:
Параметры | Значение |
---|---|
project_id | ID проекта |
Пример запроса:
`https://guild.craft-group.xyz/api/task/get-task-list?project_id=2`
Возвращает массив объектов Задачи.
Каждый объект Задачи имеет такой вид:
Передаваемые параметры объекта Задача:
Параметры | Значение |
---|---|
id | ID задачи(int) |
project_id | ID проекта(int) |
title | Название задачи(string) |
status | Статус(int) |
created_at | Дата создания(string) |
updated_at | Дата изменения(string) |
user_id_creator | ID создателя задачи(int) |
user_id | ID наблюдателя(int) |
description | Описание задачи(string) |
Если задачи не найдена будет отправлено следующее сообщение:
```json5 { "name": "Not Found", "message": "The project does not exist or there are no tasks for it", "code": 0, "status": 404, "type": "yii\\web\\NotFoundHttpException" } ``` ### Создать задачу `https://guild.craft-group.xyz/api/task/create-task`Для создания задачи необходимо отправить POST запрос на URL https://guild.craft-group.xyz/task/create-task
Требуемые параметры:
Параметры | Значение |
---|---|
project_id | ID проекта(int) |
title | Название задачи(string) |
status | Статус(int) |
user_id_creator | ID сотрудника, создатель задачи(int) |
description | Описание задачи(string) |
Пример запроса:
`http://guild.loc/api/task/create-task`
Возвращает объект Задачи.
Каждый объект Задачи имеет такой вид:
Если требуемый параметр задачи не будет получен, будет отправлено сообщение следующего вида:
```json5 { "name": "Bad Request", "message": "{\"user_id_creator\":[\"\С\о\з\д\а\т\е\л\ь cannot be blank.\"]}", "code": 0, "status": 400, "type": "yii\\web\\BadRequestHttpException" } ``` ### Изменить задачу `https://guild.craft-group.xyz/api/task/update`Для изменения задачи необходимо отправить POST запрос на URL https://guild.craft-group.xyz/task/update
Требуемые параметры:
Параметры | Значение |
---|---|
task_id | ID задачи |
Пример запроса:
`https://guild.craft-group.xyz/api/task/update`
Возвращает объект Задачи.
Каждый объект Задачи имеет такой вид:
Параметры объекта Задача:
Параметры | Значение |
---|---|
task_id | ID задачи(int) |
project_id | ID проекта(int) |
title | Название задачи(string) |
status | Статус(int) |
created_at | Дата создания(string) |
updated_at | Дата изменения(string) |
user_id_creator | ID сотрудника, создатель задачи(int) |
user_id | ID сотрудника(int) |
description | Описание задачи(string) |
Если задача не найдена будет отправлено следующее сообщение:
```json5 { "name": "Not Found", "message": "The task does not exist", "code": 0, "status": 404, "type": "yii\\web\\NotFoundHttpException" } ``` ## Исполнители задачи ### Список исполнителей задачи `https://guild.craft-group.xyz/api/task-user/get-task-users`Для получения списка исполнителей необходимо отправить GET запрос на URL https://guild.craft-group.xyz/api/task-user/get-task-users
Требуемые параметры:
Параметры | Значение |
---|---|
task_id | ID задачи |
Пример запроса:
`https://guild.craft-group.xyz/api/task-user/get-task-users?task_id=10`
Возвращает массив сотрудников проекта закреплённых за задачей.
Каждый ответ имеет такой вид:
Параметры объекта Исполнитель:
Параметры | Значение |
---|---|
id | ID исполнителя задачи(int) |
task_id | ID задачи(int) |
project_user_id | ID сотрудника на проекте(int) |
Если задача не найдена будет отправлено следующее сообщение:
```json5 { "name": "Not Found", "message": "The task does not exist or there are no employees for it", "code": 0, "status": 404, "type": "yii\\web\\NotFoundHttpException" } ``` ### Назначить сотрудника на задачу `https://guild.craft-group.xyz/api/task-user/get-task-users`Для назначения исполнителя необходимо отправить POST запрос на URL https://guild.craft-group.xyz/api/task-user/set-task-user
Требуемые параметры:
Параметры | Значение |
---|---|
task_id | ID задачи |
project_user_id | ID сотрудника на проекте |
Пример запроса:
`https://guild.craft-group.xyz/api/task-user/set-task-user`
Возвращает объект Исполнителя задачи.
Каждый ответ имеет такой вид:
Если задача не найдена будет отправлено следующее сообщение:
```json5 { "name": "Bad Request", "message": "{\"task_id\":[\"\З\а\д\а\ч\а is invalid.\"]}", "code": 0, "status": 400, "type": "yii\\web\\BadRequestHttpException" } ```