일별 통계 조회

작성자: admin 작성일: 2025-07-08
API Endpoint

GET /api/stats/daily

일별 상세 통계를 조회합니다. 특정 기간의 일별 푸시 발송 데이터와 성과를 확인할 수 있습니다.
엔드포인트: GET https://api.pushmanager.kr/api/stats/daily
GET /api/stats/daily?startDate=2024-01-01&endDate=2024-01-31&limit=30
X-API-Key: <서비스-API-키>
Origin: <등록된-도메인>

Parameters

startDate

조회 시작 날짜입니다. ISO 8601 형식 (YYYY-MM-DD)으로 입력합니다. 생략 시 최근 30일부터 조회됩니다.

endDate

조회 종료 날짜입니다. ISO 8601 형식 (YYYY-MM-DD)으로 입력하며, startDate보다 나중 날짜여야 합니다. 생략 시 오늘까지 조회됩니다.

limit

조회할 일수 제한입니다. 최대 365일까지 조회 가능하며, 기본값은 30일입니다.

Discussion

이 엔드포인트는 일별 푸시 발송 성과를 시계열로 분석할 수 있는 상세한 데이터를 제공합니다. 각 날짜별로 요청 수, 발송 건수, 성공률, 에러 분석 등을 확인할 수 있어 트렌드 분석과 성과 모니터링에 유용합니다.
최대 조회 기간: 한 번에 최대 365일
데이터 정렬: 최신 날짜 순으로 정렬
인증: 유효한 X-API-Key 헤더와 Origin 검증 필요

응답 형식

성공 응답 (200 OK)

{
  "success": true,
  "data": {
    "daily": [
      {
        "log_date": "2024-01-31",
        "total_requests": 12,
        "total_subscriptions": 180,
        "success_count": 175,
        "fail_count": 5,
        "success_rate": 97.22,
        "error_breakdown": {
          "expired": 3,
          "client_error": 2
        },
        "first_request_at": "2024-01-31T02:15:30.000Z",
        "last_request_at": "2024-01-31T18:45:22.000Z"
      },
      {
        "log_date": "2024-01-30",
        "total_requests": 8,
        "total_subscriptions": 95,
        "success_count": 92,
        "fail_count": 3,
        "success_rate": 96.84
      }
      // ... 추가 일별 데이터
    ],
    "service": {
      "siteName": "내 웹사이트",
      "siteUrl": "https://my-website.com",
      "apiKey": "your-api-key"
    },
    "period": {
      "startDate": "2024-01-01",
      "endDate": "2024-01-31",
      "limit": 30
    }
  }
}

관련 API

문서 검색