슥삭 까다로운 피니
슥삭 까다로운 피니 · GPT Actions
포스터 정보 가져오기
슥삭 사이트에서 포스터 정보를 가져옵니다.
GET /posters모든 포스터 정보 가져오기이 요청은 슥삭 사이트의 포스터 정보를 가져옵니다. 사용자는 이 엔드포인트를 사용하여 포스터의 이미지, 이름, 등록일, 마감일 등 기본적인 정보를 조회할 수 있습니다. 'ordering' 쿼리 파라미터를 사용하여 특정 조건에 따라 포스터를 정렬할 수 있습니다. 'category' 파라미터를 통해 특정 카테고리의 포스터만 필터링할 수도 있습니다. 'interestIds' 파라미터를 사용하여 사용자의 관심사에 맞는 포스터를 세밀하게 필터링할 수 있습니다. 결과를 보여줄 떄 사진을 포함해서 보여주세요.
GET /posters/{poster_id}특정 포스터 정보 가져오기이 엔드포인트는 사용자가 지정한 ID에 해당하는 포스터의 상세 정보를 제공합니다. 포스터 리스트에는 포함되지 않은 추가적인 세부 사항을 포함하여, 특정 포스터에 대한 광범위한 정보를 얻을 수 있습니다. 이 요청은 포스터의 개요, 대상, 진행 기간, 혜택 등의 상세한 내용을 확인할 수 있습니다. 사용자가 특정 포스터에 대해 깊이 있게 이해하고자 할 때 필요한 모든 정보를 제공합니다. 이를 통해 사용자는 포스터의 전체적인 맥락과 세부 사항을 파악할 수 있습니다. 특정 포스터에 대한 구체적인 정보가 필요한 경우 유용하게 사용됩니다.
Original API schema
{
"openapi": "3.1.0",
"info": {
"title": "포스터 정보 가져오기",
"description": "슥삭 사이트에서 포스터 정보를 가져옵니다.",
"version": "v1.0.0"
},
"servers": [
{
"url": "https://api.ssgsag.kr"
}
],
"paths": {
"/posters": {
"get": {
"operationId": "getPosters",
"summary": "모든 포스터 정보 가져오기",
"description": "이 요청은 슥삭 사이트의 포스터 정보를 가져옵니다. 사용자는 이 엔드포인트를 사용하여 포스터의 이미지, 이름, 등록일, 마감일 등 기본적인 정보를 조회할 수 있습니다. 'ordering' 쿼리 파라미터를 사용하여 특정 조건에 따라 포스터를 정렬할 수 있습니다. 'category' 파라미터를 통해 특정 카테고리의 포스터만 필터링할 수도 있습니다. 'interestIds' 파라미터를 사용하여 사용자의 관심사에 맞는 포스터를 세밀하게 필터링할 수 있습니다. 결과를 보여줄 떄 사진을 포함해서 보여주세요.\n",
"parameters": [
{
"name": "ordering",
"in": "query",
"description": "정렬 기준, 'save_count': 경쟁률 낮은 공고, '-save_count': 인기 있는 공고, 'end_date': 마감일 임박한 공고\n",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "category",
"in": "query",
"description": "카테고리 ID, '1': 대외활동, '0': 공모전, '7': 교육/강연, '4,9': 인턴십\n",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "interestIds",
"in": "query",
"description": "관심사 ID 목록. 쉼표로 구분된 관심사를 지정하여 해당 관심사에 해당하는 포스터를 필터링할 수 있습니다. 대외활동\n - '': 전체\n - '10000,251': 대기업 서포터즈\n - '50000,251': 공사/공기업 서포터즈\n - '252': 봉사활동\n - '255': 리뷰/체험단\n - '254': 해외봉사/탐방\n - '299': 기타\n공모전\n - '': 전체\n - '201': 기획/아이디어\n - '202': 광고/마케팅\n - '206': 영상/콘텐츠\n - '205': 디자인\n - '207': IT/SW\n - '208': 창업/스타트업\n - '215': 금융/경제\n - '204': 문학/시나리오\n - '299': 기타\n교육/강연\n - '' 전체\n - '601': IT/개발\n - '602': 마케팅\n - '603': 기획/PM\n - '604': 디자인\n - '699': 기타\n인턴십/신입(복수선택 가능, 예: '101,110,199')\n - '' 전체\n - '101': 경영/비즈니스\n - '110': 광고/마케팅\n - '104': 개발\n - '112': 디자인\n - '106': 인사/교육\n - '102': 영업\n - '107': 미디어\n - '111': 고객서비스/리테일\n - '109': 엔지니어링/설계\n - '103': 제조/생산\n - '199': 기타\n",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "pageSize",
"in": "query",
"description": "페이지 크기, 9999 고정",
"required": true,
"schema": {
"type": "integer",
"default": 9999
}
}
],
"responses": {
"200": {
"description": "성공적으로 포스터 정보를 반환",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"totalCount": {
"type": "integer"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PosterSummary"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청"
}
}
}
},
"/posters/{poster_id}": {
"get": {
"operationId": "getPosterById",
"summary": "특정 포스터 정보 가져오기",
"description": "이 엔드포인트는 사용자가 지정한 ID에 해당하는 포스터의 상세 정보를 제공합니다. 포스터 리스트에는 포함되지 않은 추가적인 세부 사항을 포함하여, 특정 포스터에 대한 광범위한 정보를 얻을 수 있습니다. 이 요청은 포스터의 개요, 대상, 진행 기간, 혜택 등의 상세한 내용을 확인할 수 있습니다. 사용자가 특정 포스터에 대해 깊이 있게 이해하고자 할 때 필요한 모든 정보를 제공합니다. 이를 통해 사용자는 포스터의 전체적인 맥락과 세부 사항을 파악할 수 있습니다. 특정 포스터에 대한 구체적인 정보가 필요한 경우 유용하게 사용됩니다.\n",
"parameters": [
{
"name": "poster_id",
"in": "path",
"required": true,
"description": "포스터의 고유 식별자",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "성공적으로 포스터의 상세 정보를 반환",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PosterDetail"
}
}
}
},
"404": {
"description": "포스터를 찾을 수 없음"
}
}
}
}
},
"components": {
"schemas": {
"PosterSummary": {
"type": "object",
"properties": {
"posterIdx": {
"type": "integer"
},
"categoryIdx": {
"type": "integer"
},
"categoryName": {
"type": "string"
},
"photoUrl": {
"type": "string"
},
"thumbPhotoUrl": {
"type": "string"
},
"posterName": {
"type": "string"
},
"posterRegDate": {
"type": "string"
},
"dday": {
"type": "integer"
}
}
},
"PosterDetail": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/PosterSummary"
},
{
"type": "object"
}
],
"properties": {
"posterStartDate": {
"type": "string",
"nullable": true
},
"posterEndDate": {
"type": "string",
"nullable": true
},
"documentDate": {
"type": "string"
},
"contentIdx": {
"type": "integer"
},
"keyword": {
"type": "string"
},
"favoriteNum": {
"type": "integer"
},
"likeNum": {
"type": "integer"
},
"saveNum": {
"type": "integer"
},
"swipeNum": {
"type": "integer"
},
"websiteClickNum": {
"type": "integer"
},
"detailShowNum": {
"type": "integer"
},
"detailShowNum2": {
"type": "integer"
},
"detailShowNum3": {
"type": "integer"
},
"isSave": {
"type": "boolean"
},
"outline": {
"type": "string"
},
"target": {
"type": "string"
},
"period": {
"type": "string",
"nullable": true
},
"benefit": {
"type": "string"
},
"applicationStatus": {
"type": "string",
"nullable": true
},
"applyResult": {
"type": "string",
"nullable": true
},
"companyName": {
"type": "string",
"nullable": true
},
"regionName": {
"type": "string",
"nullable": true
},
"jobName": {
"type": "string",
"nullable": true
},
"isAd": {
"type": "boolean"
},
"order": {
"type": "integer",
"nullable": true
},
"photoUrl2": {
"type": "string",
"nullable": true
},
"posterWebsite": {
"type": "string",
"nullable": true
},
"posterWebsite2": {
"type": "string",
"nullable": true
},
"publicOpenStartDate": {
"type": "string"
},
"publicOpenEndDate": {
"type": "string"
},
"hostIdx": {
"type": "integer"
},
"posterDetail": {
"type": "string"
},
"adminAccept": {
"type": "integer"
},
"isOnlyUniv": {
"type": "integer"
},
"isOnlyMajor": {
"type": "integer"
},
"saveAndShowNum": {
"type": "integer"
},
"mandatoryShow": {
"type": "boolean"
},
"posterInterest": {
"type": "string",
"nullable": true
},
"chargerName": {
"type": "string"
},
"partnerPhone": {
"type": "string"
},
"partnerEmail": {
"type": "string"
},
"analytics": {
"type": "string"
},
"analyticsJson": {
"type": "object"
},
"isPush": {
"type": "boolean"
}
}
}
}
}
}