메뉴

스냅포스트 사진 모델 생성 엔드포인트

2016년 12월 13일 - SnapPost edit

스냅포스트 사진 모델 생성 엔드포인트

사진을 업로드하기 위한 ImageAttachment 모델을 생성하는 엔드포인트입니다. 이 엔드포인트를 통해 생성된 ImageAttachment 모델은 request에 명시된 SnapPost 모델과 morphTo/morphMany 관계로 연관되며, 이미지 파일은 업로드 또는 연관되지 않은 상태입니다.

Endpoint

POST /{api_version}/snap-post/attach-image/{post_id}?count={int}&after={int}

api_version은 API 버전 슬러그, post_id는 스냅포스트 모델 id(pk)로 치환하시기 바랍니다.
count 파라미터는 생성해야 할 ImageAttachment 모델의 개수입니다.
after 파라미터는 새로 생성된 ImageAttachment의 순서를 지정하는 데에 사용되며, SnapPost 모델의 image_order 속성(ImageAttachment 모델 id 배열)에 포함된 값을 사용해야 합니다.

특이사항

count 파라미터가 정의되지 않은 경우 기본 값은 1로 설정됩니다.
after 파라미터가 정의되지 않거나, SnapPost 모델의 image_order 속성에 없는 값이 사용된 경우 기본적으로 새로 생성된 ImageAttachment 모델들의 id 값들은 image_order 배열의 마지막에 추가됩니다.

HTTP response codes

200 성공.
404 존재하지 않는 모델의 데이터를 요청한 경우.
403 소유권이 사용자에게 없는 모델의 데이터를 요청하는 경우.

반환값

Standard Response Structure의 data 속성에 ImageAttachment 모델을 반환합니다.