푸시 발송 통계 조회
API Endpoint
GET /api/stats/my
내 서비스의 푸시 발송 통계를 조회합니다. 일별, 월별 또는 전체 기간의 통계 데이터를 확인할 수 있습니다.
엔드포인트: GET https://api.pushmanager.kr/api/stats/my
GET /api/stats/my?period=month&startDate=2024-01-01&endDate=2024-01-31
X-API-Key: <서비스-API-키>
Origin: <등록된-도메인>
X-API-Key: <서비스-API-키>
Origin: <등록된-도메인>
Parameters
period
조회할 통계 기간을 지정합니다.
day (오늘), month (이번 달), all (전체 기간) 중 하나를 선택할 수 있습니다. 기본값은 month입니다.
startDate
커스텀 기간 조회 시 시작 날짜입니다. ISO 8601 형식 (YYYY-MM-DD)으로 입력합니다.
period가 custom일 때만 사용됩니다.
endDate
커스텀 기간 조회 시 종료 날짜입니다. ISO 8601 형식 (YYYY-MM-DD)으로 입력하며,
startDate보다 나중 날짜여야 합니다.
Discussion
이 엔드포인트는 서비스의 푸시 발송 성과를 분석할 수 있는 상세한 통계 정보를 제공합니다. 요약 통계와 함께 일별 세부 데이터도 포함되어 시계열 분석이 가능합니다. 모든 통계는 실시간으로 업데이트되며, 푸시 발송 즉시 반영됩니다.
데이터 범위: 자신의 API 키로 발송한 푸시만 조회 가능
실시간 업데이트: 푸시 발송 즉시 통계 반영
인증: 유효한 X-API-Key 헤더와 Origin 검증 필요
실시간 업데이트: 푸시 발송 즉시 통계 반영
인증: 유효한 X-API-Key 헤더와 Origin 검증 필요
응답 형식
성공 응답 (200 OK)
{
"success": true,
"data": {
"summary": {
"total_requests": 150,
"total_subscriptions": 2500,
"success_count": 2350,
"fail_count": 150,
"success_rate": 94.0,
"active_days": 25,
"avg_daily_requests": 6.0
},
"daily": [
{
"log_date": "2024-01-15",
"total_requests": 8,
"total_subscriptions": 120,
"success_count": 115,
"fail_count": 5,
"success_rate": 95.8
}
// ... 추가 일별 데이터
],
"monthly": [
{
"period": "2024-01",
"total_requests": 150,
"success_rate": 94.0
}
],
"service": {
"siteName": "내 웹사이트",
"siteUrl": "https://my-website.com",
"apiKey": "your-api-key",
"createdAt": "2024-01-01T00:00:00.000Z"
},
"period": "month",
"startDate": "2024-01-01",
"endDate": "2024-01-31"
}
}
"success": true,
"data": {
"summary": {
"total_requests": 150,
"total_subscriptions": 2500,
"success_count": 2350,
"fail_count": 150,
"success_rate": 94.0,
"active_days": 25,
"avg_daily_requests": 6.0
},
"daily": [
{
"log_date": "2024-01-15",
"total_requests": 8,
"total_subscriptions": 120,
"success_count": 115,
"fail_count": 5,
"success_rate": 95.8
}
// ... 추가 일별 데이터
],
"monthly": [
{
"period": "2024-01",
"total_requests": 150,
"success_rate": 94.0
}
],
"service": {
"siteName": "내 웹사이트",
"siteUrl": "https://my-website.com",
"apiKey": "your-api-key",
"createdAt": "2024-01-01T00:00:00.000Z"
},
"period": "month",
"startDate": "2024-01-01",
"endDate": "2024-01-31"
}
}
사용 예시
// 이번 달 통계 조회
const response = await fetch('https://api.pushmanager.kr/api/stats/my?period=month', {
headers: {
'X-API-Key': 'your-api-key-here'
}
});
const { data } = await response.json();
console.log(`성공률: ${data.summary.success_rate}%`);
console.log(`총 발송: ${data.summary.total_subscriptions}건`);
// 커스텀 기간 조회
const customStats = await fetch(
'https://api.pushmanager.kr/api/stats/my?period=custom&startDate=2024-01-01&endDate=2024-01-31',
{ headers: { 'X-API-Key': 'your-api-key' } }
);
const response = await fetch('https://api.pushmanager.kr/api/stats/my?period=month', {
headers: {
'X-API-Key': 'your-api-key-here'
}
});
const { data } = await response.json();
console.log(`성공률: ${data.summary.success_rate}%`);
console.log(`총 발송: ${data.summary.total_subscriptions}건`);
// 커스텀 기간 조회
const customStats = await fetch(
'https://api.pushmanager.kr/api/stats/my?period=custom&startDate=2024-01-01&endDate=2024-01-31',
{ headers: { 'X-API-Key': 'your-api-key' } }
);