Skip to Content
OpenAPIAPI 레퍼런스콘텐츠 뻐꾸기 API

콘텐츠 뻐꾸기 API

공모전, 이벤트 등 콘텐츠 정보를 조회하는 API입니다.


콘텐츠 목록 조회

Endpoint
GET /v1/contents

Request

Query Parameters

NameTypeDefault
pagenumber

페이지 번호

1
limitnumber

결과 수 (최대 100)

20
qstring

통합 검색어

titlestring

제목 검색

tagIdsstring

태그 ID (쉼표 구분)

statuses"RECRUITING" | "CLOSED" | "UPCOMING" | "ALWAYS_OPEN"

상태 필터

order"deadline_latest" | "deadline_closest" | "created_oldest" | "created_latest"

정렬 기준

recruitStartFromstring

모집 시작일 시작 범위 (ISO 8601)

recruitStartTostring

모집 시작일 종료 범위 (ISO 8601)

recruitEndFromstring

모집 종료일 시작 범위 (ISO 8601)

recruitEndTostring

모집 종료일 종료 범위 (ISO 8601)

contentFromstring

콘텐츠 일정 시작 범위 (ISO 8601)

contentTostring

콘텐츠 일정 종료 범위 (ISO 8601)

Response

NameTypeDefault
itemsContentResponse[]

콘텐츠 목록

paginationPagination

페이지네이션 정보

Examples

Terminal
# 모집 중인 콘텐츠 조회 curl "https://openapi.meloming.com/v1/contents?statuses=RECRUITING&limit=20" # 마감 임박순 정렬 curl "https://openapi.meloming.com/v1/contents?statuses=RECRUITING&order=deadline_closest" # 태그로 필터링 curl "https://openapi.meloming.com/v1/contents?tagIds=1,2,3"

콘텐츠 상세 조회

Endpoint
GET /v1/contents/{id}

Request

Path Parameters

NameTypeDefault
idnumber

콘텐츠 ID

Query Parameters

NameTypeDefault
incrementViewboolean

조회수 증가 여부

true

Response

NameTypeDefault
idnumber

콘텐츠 ID

titlestring

콘텐츠 제목

descriptionstring

설명

contentstring

상세 내용 (HTML/Markdown)

thumbnailUrlstring

썸네일 이미지 URL

bannerUrlstring

배너 이미지 URL

status"RECRUITING" | "CLOSED" | "UPCOMING" | "ALWAYS_OPEN"

상태

recruitStartAtstring

모집 시작일 (ISO 8601)

recruitEndAtstring

모집 종료일 (ISO 8601)

contentStartAtstring

콘텐츠 시작일 (ISO 8601)

contentEndAtstring

콘텐츠 종료일 (ISO 8601)

viewCountnumber

조회수

participantCountnumber

참가자 수

maxParticipantsnumber

최대 참가자 수 (0 = 무제한)

requirementsstring

참가 조건

rewardsstring

리워드 정보

rulesstring

참가 규칙

contactEmailstring

문의 이메일

externalUrlstring

외부 링크

tags{ id: number; name: string; }[]

태그 목록

organizer{ id: number; name: string; profileImageUrl: string; }

주최자 정보

createdAtstring

생성일 (ISO 8601)

updatedAtstring

수정일 (ISO 8601)

Examples

Terminal
# 기본 조회 (조회수 증가) curl https://openapi.meloming.com/v1/contents/123 # 조회수 증가 없이 조회 curl "https://openapi.meloming.com/v1/contents/123?incrementView=false"

콘텐츠 참가 신청 및 관리 API는 OAuth 인증이 필요하며, 추후 별도 문서로 안내될 예정입니다.

Last updated on