📡 XDate API 사용 방법

XDate에서는 다음과 같은 방식으로 API를 호출하여 미래 예측 데이터를 가져올 수 있습니다.

1. 전체 토픽 목록 가져오기

전체 예측 주제 목록을 가져옵니다.

GET https://xdate.kr/get.php

응답 예시:

[
    {
        "id": 1,
        "title": "대한민국 인구 절벽 시계",
        "desc": "출생률 하락으로 인한 급격한 인구 감소가 시작되는 시점까지 남은 시간\n(데이터셋: KOSIS)",
        "deadline": "2025-01-01 00:00:00"
    },
    {
        "id": 2,
        "title": "대한민국 지방 소멸 시계",
        "desc": "부산과 광주가 동시에 소멸위험지수 1.0 미만에 진입할 시점까지 남은 시간\n(데이터셋: KOSIS)",
        "deadline": "2024-11-30 23:59:42"
    }
]

2. 개별 주제 정보 가져오기

예: 대한민국 인구 절벽 시계 API

GET https://xdate.kr/get.php?id=1

응답 예시:

{
    "id": 1,
    "title": "대한민국 인구 절벽 시계",
    "desc": "출생률 하락으로 인한 급격한 인구 감소가 시작되는 시점까지 남은 시간\n(데이터셋: KOSIS)",
    "deadline": "2025-01-01 00:00:00"
}

3. 날짜 관련

deadline은 YYYY-MM-DD HH:mm:ss 형식입니다.

4. 호출 제한

본 API는 10초당 1회 호출만 허용됩니다. 이 제한을 초과하여 연속 호출 시 429 Too Many Requests 에러가 반환됩니다. 클라이언트에서는 적절한 지연(backoff) 로직을 구현해주세요.

문의

문의: support@xdate.kr

← 돌아가기