공개 API v1

RescueAnimal 읽기 전용 공개 API입니다. 쓰기·삭제·개인정보 필드는 제공하지 않습니다. API 키는 사용량이 커지기 전까지 발급하지 않습니다.

정책

read-only (GET)
rate limit: IP당 60요청 / 60초 (초과 시 429)
pagination: page, limit (기본 20, 최대 50)
cache: 60초 (Cache-Control + 서버 단기 캐시)
version: URL 경로 /api/public/v1
오류 형식: {"ok":false,"error":{"code","message"},"meta":{"version"}}
성공 형식: {"ok":true,"data":...,"meta":{version,page,limit,total,attribution}}

출처: RescueAnimal (https://rescueanimal.kr). 출처 표기 후 이용해 주세요.

엔드포인트

GET /api/public/v1/animals

현재 보호 중인 구조동물. 파라미터: region, kind(DOG|CAT|ETC), size(small|medium|large), page, limit. 체중이 없으면 크기를 추정하지 않습니다.

GET /api/public/v1/animals/{id}

단건. 없는 번호는 404.

GET /api/public/v1/shelters

보호소 목록. 파라미터: region, page, limit. 전화번호·좌표는 포함하지 않습니다.

GET /api/public/v1/lost

공개 실종 신고. 시도 단위 지역만 포함하고 연락처·좌표·본문은 제외합니다.

예제

GET https://rescueanimal.kr/api/public/v1/animals?region=수원&kind=DOG&limit=6

{
  "ok": true,
  "data": [
    {
      "id": 1,
      "kind": "개",
      "species": "DOG",
      "breed": "믹스견",
      "url": "https://rescueanimal.kr/animals/1"
    }
  ],
  "meta": {
    "version": "v1",
    "page": 1,
    "limit": 6,
    "attribution": "RescueAnimal (https://rescueanimal.kr). 출처 표기 후 이용해 주세요."
  }
}

포함하지 않는 필드

전화번호, 이메일, 연락처, 작성자, 좌표, 원본 JSON, 실종 신고 본문, 세션·IP.

위젯

사이트에 카드를 넣으려면 위젯 만들기에서 코드를 복사하세요. 집계는 widget load, outbound click, referring domain만 모으며 개인을 식별하지 않습니다.