PUT /cards/{id}/move

설명

카드를 지정된 위치로 이동합니다

이 경로는 cards/{id}/move 경로로 전송되는 HTTP PUT 요청을 처리합니다.

경로 매개변수

다음 매개변수가 요청 라인에 포함되어 전송됩니다:

이름	타입	설명
id	number	필수. 이동할 카드의 ID입니다. 여러 카드를 이동하려는 경우, id는 0으로 설정해야 합니다.

정보

여러 카드를 이동할 때는 반드시 id를 0으로 설정해야 합니다. 그렇지 않고 다른 값으로 설정하면 지정된 id 값을 가진 카드 한 장만 이동됩니다.

페이로드

서버는 다음 속성을 가진 JSON 객체를 받기를 기대합니다:

이름	타입	설명
id	number	필수. 이동할 카드의 ID입니다.
columnId	number	필수. 카드가 이동할 열의 ID입니다.
rowId	number	필수. 카드가 이동할 행의 ID입니다.
before	number	선택. 이동한 카드가 위치할 카드의 바로 앞에 놓일 카드의 ID입니다.
batch	object	다중 선택 시 필수. 이동할 카드 객체들의 배열입니다.

예제:

{
    "id": 4,
    "columnId": 2,
    "rowId": 1,
    "before": "7"
}

여러 카드를 이동하는 경우, batch 속성은 이동할 모든 카드 객체의 배열을 포함해야 합니다:

{
    "batch": [
        {
            "id": 2,
            "columnId": 1,
            "rowId": 1,
            "before": "1"
        },
        {
            "id": 7,
            "columnId": 1,
            "rowId": 1,
            "before": "1"
        }
    ]
}

응답

서버는 카드 ID가 포함된 JSON 객체를 반환합니다(한 장의 카드가 이동된 경우) 또는 다중 카드 작업의 경우 ID가 0으로 설정된 객체를 반환합니다.

예제:

단일 카드 작업에 대한 응답

{
    "id": 4
}

다중 카드 작업에 대한 응답

{
    "id": 0
}

HTTP 상태 코드는 요청이 성공했는지(response.status == 200) 실패했는지(response.status == 500)를 나타냅니다.

---

관련 문서: 서버 작업하기