Portfolio

실종/보호 게시글 등록 API

완료여부

상태

201

uri

/api/v1/missing-posts

담당자

범키

비고

enum 값들 토의

프론트 확인

태그

POST

POST 요청으로 실종/보호 게시글을 등록한다.

Content-Type: multipart/form-data

업로드할 파일을 images 필드에 담아 요청합니다.

Request Header


Authorization: "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"

Request Body


data = {
	"images": formData((key,value), (key,value), (key, value))
	"param": {
		"status": "DETECTION",
	  "date": "2021-11-01",
	  "cityId": 1,
	  "townId": 1,
	  "detailAddress": "주민센터 앞 골목 근처",
	  "telNumber": "01077320920",
	  "animalId": 2,
	  "animalKindName": "푸들", // 모를시 "UNKNOWN" + 기타 animal의 animalId
	  "age": 10, // 모름일시 -1
	  "sex": "FEMALE", // "UNKNOWN"
	  "chipNumber": "410123456789112",
	  "content" : "찾아주시면 반드시 사례하겠습니다. 연락주세요",
	  "tags": [
	    {
	      "name": "고슴도치"
	    }
	  ]
	}
}

Request Field

이름

타입

설명

requried

비고

validation

images

File

게시글 이미지

param.status

String

게시글 상태

requried

MISSING, DETECTION, PROTECTION, COMPLETION

param.date

String

상태 날짜

requried

목격, 발견, 실종, 완료

param.cityId

Number

시도 id

requried

param.townId

Number

시군구 id

requried

param.detailAddress

String

상세 및 추가 주소

max = 255

param.telNumber

String

연락처

requried

max = 15

param.animalId

Number

동물 id

requried

param.animalKindName

String

품종 이름

requried

모름 : UNKNOWN, max = 50

param.age

Number

나이

requried

모름 : -1, max = 500

param.sex

String

성별

requried

FEMALE, MALE, UNKNOWN(모름)

param.chipNumber

String

칩번호

requried

max = 15

param.content

String

내용

requried

max = 255

param.tags

ARRAY

게시글의 해시태그들

requried

param.tags[].name

String

해시태그 값

Response


{
  "data": {
		"id" : 13
  },
  "serverDateTime": "2021-11-05T16:55:37.436056"
}

Response Fields

이름

타입

설명

비고

data

Obejct

응답 본문

data.id

Number

생성된 게시글 id

serverDateTime

String

서버 응답 시간

이미지 업로드는 따로 서비스로 빼고 게시글 + 이미지 업로드까지 한 트랜잭션으로 처리