오늘냥이 (Oneul Nyangi)

{
  "type": "object",
  "examples": [
    {
      "years": 5
    },
    {
      "locale": "en",
      "months": 8
    }
  ],
  "properties": {
    "years": {
      "type": "number",
      "maximum": 30,
      "minimum": 0,
      "description": "고양이 나이(년). 소수 가능, 예: 1.5"
    },
    "fields": {
      "type": "array",
      "items": {
        "enum": [
          "ageMonths",
          "humanAgeYears",
          "lifeStage.id",
          "lifeStage.name",
          "answer",
          "method",
          "disclaimer",
          "webUrl",
          "source.name",
          "source.url"
        ],
        "type": "string"
      },
      "maxItems": 32,
      "minItems": 1,
      "description": "선택. 필요한 공개 결과 필드만 반환합니다. 배열 안 필드는 photos.url처럼 지정합니다.",
      "uniqueItems": true
    },
    "locale": {
      "enum": [
        "ko",
        "en",
        "ja"
      ],
      "type": "string",
      "default": "ko",
      "description": "answer 문장의 언어"
    },
    "months": {
      "type": "integer",
      "maximum": 360,
      "minimum": 0,
      "description": "고양이 나이(개월)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "examples": [
    {
      "weightKg": 4
    },
    {
      "locale": "en",
      "status": "intact_adult",
      "weightKg": 5
    }
  ],
  "required": [
    "weightKg"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "enum": [
          "input.weightKg",
          "input.status",
          "input.dryFoodKcalPerKg",
          "restingKcal",
          "dailyKcal",
          "dryFoodGrams",
          "wetFoodKcal",
          "perMealGrams.twoMeals",
          "perMealGrams.threeMeals",
          "waterMl.min",
          "waterMl.max",
          "answer",
          "method",
          "disclaimer",
          "webUrl",
          "source.name",
          "source.url"
        ],
        "type": "string"
      },
      "maxItems": 32,
      "minItems": 1,
      "description": "선택. 필요한 공개 결과 필드만 반환합니다. 배열 안 필드는 photos.url처럼 지정합니다.",
      "uniqueItems": true
    },
    "locale": {
      "enum": [
        "ko",
        "en",
        "ja"
      ],
      "type": "string",
      "default": "ko",
      "description": "answer 문장의 언어"
    },
    "status": {
      "enum": [
        "neutered_adult",
        "intact_adult",
        "inactive_obese_prone",
        "growing_kitten"
      ],
      "type": "string",
      "default": "neutered_adult",
      "description": "neutered_adult 중성화 성묘 / intact_adult 중성화 안 한 성묘 / inactive_obese_prone 체중이 늘기 쉬운 성묘 / growing_kitten 성장기 자묘"
    },
    "weightKg": {
      "type": "number",
      "maximum": 20,
      "minimum": 0.3,
      "description": "고양이 몸무게(kg)"
    },
    "wetFoodPouches": {
      "type": "integer",
      "default": 0,
      "maximum": 10,
      "minimum": 0,
      "description": "하루에 주는 습식 사료 파우치 수"
    },
    "dryFoodKcalPerKg": {
      "type": "number",
      "default": 3800,
      "maximum": 6000,
      "minimum": 2000,
      "description": "건식 사료 1kg당 열량(kcal). 포장 표기 기준"
    },
    "wetFoodKcalPerPouch": {
      "type": "number",
      "default": 70,
      "maximum": 300,
      "minimum": 20,
      "description": "습식 사료 파우치 1개의 열량(kcal)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "examples": [
    {
      "catId": "00000000-0000-4000-8000-000000000102"
    }
  ],
  "required": [
    "catId"
  ],
  "properties": {
    "catId": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "고양이 프로필 UUID"
    },
    "fields": {
      "type": "array",
      "items": {
        "enum": [
          "id",
          "url",
          "webUrl",
          "name",
          "breed",
          "breedId",
          "intro",
          "avatar",
          "imageUrl",
          "thumbnail",
          "age",
          "gender",
          "personalityTags",
          "isMemorial",
          "recentPostsTotal",
          "recentPostsHasMore",
          "recentPostsNextCursor",
          "recentPosts.id",
          "recentPosts.url",
          "recentPosts.webUrl",
          "recentPosts.caption",
          "recentPosts.tags",
          "recentPosts.recordDate",
          "recentPosts.image",
          "recentPosts.imageUrl",
          "recentPosts.thumbnail",
          "recentPosts.catId",
          "recentPosts.catUrl",
          "recentPosts.reactions.likes",
          "recentPosts.reactions.cute",
          "recentPosts.reactions.funny",
          "recentPosts.reactions.total",
          "recentPosts.discovery.source",
          "recentPosts.discovery.coverage",
          "recentPosts.discovery.confidence",
          "recentPosts.discovery.observedAt",
          "recentPosts.discovery.attributes.breed",
          "recentPosts.discovery.attributes.coatColor",
          "recentPosts.discovery.attributes.pose",
          "recentPosts.discovery.attributes.activity",
          "recentPosts.discovery.attributes.scene",
          "recentPosts.discovery.attributes.mood"
        ],
        "type": "string"
      },
      "maxItems": 32,
      "minItems": 1,
      "description": "선택. 필요한 공개 결과 필드만 반환합니다. 배열 안 필드는 photos.url처럼 지정합니다.",
      "uniqueItems": true
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "examples": [
    {
      "postId": "531d8700-1d25-4d2a-961c-b5a85c28c357"
    }
  ],
  "required": [
    "postId"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "enum": [
          "id",
          "url",
          "webUrl",
          "caption",
          "tags",
          "recordDate",
          "image",
          "imageUrl",
          "thumbnail",
          "catId",
          "catUrl",
          "reactions.likes",
          "reactions.cute",
          "reactions.funny",
          "reactions.total",
          "discovery.source",
          "discovery.coverage",
          "discovery.confidence",
          "discovery.observedAt",
          "discovery.attributes.breed",
          "discovery.attributes.coatColor",
          "discovery.attributes.pose",
          "discovery.attributes.activity",
          "discovery.attributes.scene",
          "discovery.attributes.mood",
          "createdAt",
          "images",
          "cat.id",
          "cat.url",
          "cat.webUrl",
          "cat.name",
          "cat.breed",
          "cat.breedId",
          "cat.intro",
          "cat.avatar",
          "cat.imageUrl",
          "cat.thumbnail",
          "relatedCat.id",
          "relatedCat.url",
          "relatedCat.webUrl",
          "relatedCat.name",
          "relatedCat.breed",
          "relatedCat.breedId",
          "relatedCat.intro",
          "relatedCat.avatar",
          "relatedCat.imageUrl",
          "relatedCat.thumbnail",
          "relatedPosts.id",
          "relatedPosts.url",
          "relatedPosts.webUrl",
          "relatedPosts.caption",
          "relatedPosts.tags",
          "relatedPosts.recordDate",
          "relatedPosts.image",
          "relatedPosts.imageUrl",
          "relatedPosts.thumbnail",
          "relatedPosts.catId",
          "relatedPosts.catUrl",
          "relatedPosts.reactions.likes",
          "relatedPosts.reactions.cute",
          "relatedPosts.reactions.funny",
          "relatedPosts.reactions.total",
          "relatedPosts.discovery.source",
          "relatedPosts.discovery.coverage",
          "relatedPosts.discovery.confidence",
          "relatedPosts.discovery.observedAt",
          "relatedPosts.discovery.attributes.breed",
          "relatedPosts.discovery.attributes.coatColor",
          "relatedPosts.discovery.attributes.pose",
          "relatedPosts.discovery.attributes.activity",
          "relatedPosts.discovery.attributes.scene",
          "relatedPosts.discovery.attributes.mood",
          "relatedPosts.relation",
          "relatedPosts.matchedFacets",
          "relatedPosts.matchScore"
        ],
        "type": "string"
      },
      "maxItems": 32,
      "minItems": 1,
      "description": "선택. 필요한 공개 결과 필드만 반환합니다. 배열 안 필드는 photos.url처럼 지정합니다.",
      "uniqueItems": true
    },
    "postId": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "게시물 UUID"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "examples": [
    {
      "category": "long"
    },
    {}
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "enum": [
          "total",
          "webUrl",
          "breeds.id",
          "breeds.label",
          "breeds.category",
          "breeds.categoryLabel",
          "breeds.pageUrl",
          "breeds.feedUrl"
        ],
        "type": "string"
      },
      "maxItems": 32,
      "minItems": 1,
      "description": "선택. 필요한 공개 결과 필드만 반환합니다. 배열 안 필드는 photos.url처럼 지정합니다.",
      "uniqueItems": true
    },
    "category": {
      "enum": [
        "short",
        "long",
        "large",
        "rare",
        "mixed"
      ],
      "type": "string",
      "description": "short 단모종 / long 장모종 / large 대형묘 / rare 희귀묘 / mixed 코숏·믹스"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "examples": [
    {
      "sort": "cute",
      "limit": 6
    },
    {
      "sort": "latest",
      "query": "케이짱"
    }
  ],
  "properties": {
    "sort": {
      "enum": [
        "popular",
        "latest",
        "cute",
        "funny",
        "random"
      ],
      "type": "string",
      "default": "popular",
      "description": "popular(인기), latest(최신), cute(귀여워요), funny(웃겨요), random(무작위)"
    },
    "limit": {
      "type": "integer",
      "default": 6,
      "maximum": 12,
      "minimum": 1,
      "description": "보여줄 사진 수"
    },
    "query": {
      "type": "string",
      "maxLength": 80,
      "description": "선택. 품종·고양이 이름·태그·분위기 (예: 러시안 블루, 치즈냥이, 잠자는). 비우면 전체에서 골라요."
    },
    "cursor": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "description": "The previous nextCursor. Keep query, facets, sort and kind unchanged."
    },
    "facets": {
      "type": "object",
      "properties": {
        "mood": {
          "type": "string",
          "maxLength": 40,
          "minLength": 1,
          "description": "An observed photo attribute (English code or Korean/Japanese term), or a recorded caption/tag term. Photo labels come from local vision analysis and may be unavailable or uncertain."
        },
        "pose": {
          "type": "string",
          "maxLength": 40,
          "minLength": 1,
          "description": "An observed photo attribute (English code or Korean/Japanese term), or a recorded caption/tag term. Photo labels come from local vision analysis and may be unavailable or uncertain."
        },
        "breed": {
          "type": "string",
          "maxLength": 40,
          "minLength": 1,
          "description": "Breed ID or a recorded breed name"
        },
        "scene": {
          "type": "string",
          "maxLength": 40,
          "minLength": 1,
          "description": "An observed photo attribute (English code or Korean/Japanese term), or a recorded caption/tag term. Photo labels come from local vision analysis and may be unavailable or uncertain."
        },
        "activity": {
          "type": "string",
          "maxLength": 40,
          "minLength": 1,
          "description": "An observed photo attribute (English code or Korean/Japanese term), or a recorded caption/tag term. Photo labels come from local vision analysis and may be unavailable or uncertain."
        },
        "coatColor": {
          "type": "string",
          "maxLength": 40,
          "minLength": 1,
          "description": "An observed photo attribute (English code or Korean/Japanese term), or a recorded caption/tag term. Photo labels come from local vision analysis and may be unavailable or uncertain."
        }
      },
      "additionalProperties": false
    },
    "fields": {
      "type": "array",
      "items": {
        "enum": [
          "source.name",
          "source.url",
          "query",
          "breed",
          "matched",
          "sort",
          "moreUrl",
          "webUrl",
          "total",
          "catTotal",
          "postTotal",
          "hasMore",
          "nextCursor",
          "photos.postId",
          "photos.url",
          "photos.webUrl",
          "photos.image",
          "photos.imageUrl",
          "photos.thumbnail",
          "photos.caption",
          "photos.catId",
          "photos.catName",
          "photos.catUrl",
          "photos.breed",
          "photos.recordDate",
          "photos.reactions.likes",
          "photos.reactions.cute",
          "photos.reactions.funny",
          "photos.reactions.total",
          "photos.discovery.source",
          "photos.discovery.coverage",
          "photos.discovery.confidence",
          "photos.discovery.observedAt",
          "photos.discovery.attributes.breed",
          "photos.discovery.attributes.coatColor",
          "photos.discovery.attributes.pose",
          "photos.discovery.attributes.activity",
          "photos.discovery.attributes.scene",
          "photos.discovery.attributes.mood",
          "photos.popularity.metric",
          "photos.popularity.score"
        ],
        "type": "string"
      },
      "maxItems": 32,
      "minItems": 1,
      "description": "선택. 필요한 공개 결과 필드만 반환합니다. 배열 안 필드는 photos.url처럼 지정합니다.",
      "uniqueItems": true
    }
  },
  "additionalProperties": false
}