tlo.korea.ac.kr

{
  "type": "object",
  "properties": {
    "categories": {
      "type": "string"
    },
    "keyword": {
      "type": "string"
    },
    "recruitmentStatus": {
      "type": "string",
      "enum": [
        "OPEN",
        "CLOSING_SOON",
        "CLOSED"
      ],
      "description": "모집상태 — OPEN(모집중) / CLOSING_SOON(마감임박, 종료 7일 이내) / CLOSED(마감). 모집 종료일에서 실시간 파생하며 생략 시 전체."
    },
    "createdFrom": {
      "type": "string",
      "description": "등록일(createdAt) 시작 — 해당 날짜 00:00:00 이상. 형식: yyyy-MM-dd. 생략 시 하한 없음"
    },
    "createdTo": {
      "type": "string",
      "description": "등록일(createdAt) 종료 — 해당 날짜 23:59:59 이하(포함). 형식: yyyy-MM-dd. 생략 시 상한 없음"
    },
    "page": {
      "type": "integer",
      "description": "페이지 번호(1-based, 모든 도메인 공통). page ≥ 1이며, 1 미만(0/음수) 값이 들어오면 첫 페이지(1)로 자동 보정된다."
    },
    "size": {
      "type": "integer"
    },
    "desc": {
      "type": "array",
      "items": {
        "type": "boolean"
      },
      "description": "정렬 방향 배열. `sort` 와 인덱스로 짝을 이룬다(true=내림차순, 미지정=오름차순). Spring 표준 표기 `sort=필드,desc` 를 쓰면 이 배열은 필요 없다."
    },
    "sort": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "정렬 키 배열. 허용 키는 **오퍼레이션마다 다르며** 대개 그 목록의 백킹 테이블 컬럼이다. camelCase(`createdAt`)·snake_case(`created_at`) 둘 다 받는다(서버가 폴백 변환). ⚠️ 모르는 키의 처리가 **오퍼레이션마다 다르다** — 대부분은 `F302`(400)로 거부하지만 일부 목록은 **조용히 무시**하고 200 을 돌려준다(정렬만 안 먹는다). 허용 키를 명시한 오퍼레이션은 그 설명을 따른다. 생략 시 도메인 기본 정렬이며, 정렬을 명시하면 상단고정(`fixed`) 우선 정렬이 해제된다."
    }
  },
  "additionalProperties": false
}