Разработка богатого API, который обрабатывает как удаление, так и обновление - PullRequest
0 голосов
/ 23 декабря 2019

Я разрабатываю API, который будет использоваться для удаления и обновления ресурсов такого же типа.

Текущий дизайн API:

/employee/family-members POST

body

{
    deletedFamilyMembers: [{
        id: 1,
        name  : 'Julia',
        employee: 8,
        dob: '1984-05-21',
        relation: 2,
        dependant: true
    }, {
        id: 2,
        name : 'Dave',
        employee: 8,
        dob: '1971-05-21',
        relation: 1,
        dependant: true
    }],
    familyMembers: [{
        id: 3,
        name  : 'Robert',
        employee: 8,
        dob: '1963-05-21',
        relation: 3,
        dependant: true
    }, {
        employee: 8,
        name  : 'Ivan',
        dob: '1965-05-21',
        relation: 3,
        dependant: true
    }]
}

В случае успеха API возвращает список сохраненных членов семьи со статусом ответа 200

[{
        id: 3,
        name  : 'Robert',
        employee: 8,
        dob: '1963-05-21',
        relation: 3,
        dependant: true
    }, {
        id: 4,
        employee: 8,
        name  : 'Ivan',
        dob: '1965-05-21',
        relation: 3,
        dependant: true
    }]

Если упоминается какой-либо из членов семейства в массиве deleFamilyMembers, то в API возвращается ошибка с текстом Cannot delete as the family member is being referred с резонансным статусом 409

Предложить изменения, необходимые для обеспечения его совместимостис лучшими практиками ОТДЫХА.

...