사용
사용 API는 구독에 대한 REST API 사용 및 오류 활동에 대한 요약을 제공합니다. 이러한 엔드포인트는 통합을 모니터링하고, 일별 호출 볼륨을 추적하고, 시간 경과에 따른 오류 트렌드를 식별하는 데 유용합니다.
사용 데이터에는 총 API 호출 수 및 사용자별 분류가 포함됩니다. 오류 데이터에는 오류의 총 횟수와 오류 코드별 분류가 포함됩니다.
사용 API는 다른 Marketo REST API와 동일한 인증 방법을 사용합니다. Authorization: Bearer {accessToken} 헤더에 액세스 토큰을 전달합니다.
엔드포인트
메서드
경로
설명
GET
/rest/v1/stats/usage.json현재 날짜의 API 사용을 검색합니다.
GET
/rest/v1/stats/usage/last7days.json지난 7일 동안의 API 사용을 검색합니다.
GET
/rest/v1/stats/errors.json현재 날짜의 API 오류를 검색합니다.
GET
/rest/v1/stats/errors/last7days.json지난 7일 동안의 API 오류를 검색합니다.
일일 사용량
현재 날짜의 API 사용을 검색합니다.
GET /rest/v1/stats/usage.json
{
"requestId": "5f7f#17d7d8f2b6f",
"success": true,
"result": [
{
"date": "2015-10-17",
"total": 1120,
"users": [
{
"userId": "some.body@yahoo.com",
"count": 200
},
{
"userId": "some.body@marketo.com",
"count": 200
},
{
"userId": "some.body@gmail.com",
"count": 720
}
]
}
]
}
result 배열의 각 개체에는 하루 동안의 사용 합계와 사용자별 분류가 포함되어 있습니다.
최근 7일 사용
지난 7일 동안의 API 사용을 검색합니다. result 배열의 각 요소는 1일을 나타냅니다.
GET /rest/v1/stats/usage/last7days.json
일일 오류
현재 날짜의 API 오류를 검색합니다.
GET /rest/v1/stats/errors.json
{
"requestId": "5f7f#17d7d8f2b6f",
"success": true,
"result": [
{
"date": "2015-10-17",
"total": 73,
"errors": [
{
"errorCode": "604",
"count": 1
},
{
"errorCode": "609",
"count": 56
},
{
"errorCode": "610",
"count": 16
}
]
}
]
}
result 배열의 각 개체에는 하루 동안의 오류 합계와 오류 코드별 분류가 포함되어 있습니다.
최근 7일 오류
지난 7일 동안의 API 오류를 검색합니다. result 배열의 각 요소는 1일을 나타냅니다.
GET /rest/v1/stats/errors/last7days.json
응답 멤버
사용 결과 개체
이름
데이터 유형
설명
date문자열
YYYY-MM-DD 형식의 사용 요약 날짜입니다.total정수
해당 날짜의 총 API 호출 수
users배열
해당 날짜의 사용자당 사용량 목록.
사용 사용자 개체
이름
데이터 유형
설명
userId문자열
API 사용자 식별자.
count정수
해당 사용자가 하루 동안 수행한 API 호출 수입니다.
오류 결과 개체
이름
데이터 유형
설명
date문자열
오류 요약 날짜가
YYYY-MM-DD 형식입니다.total정수
해당 날짜의 총 API 오류 수입니다.
errors배열
해당 날짜의 오류 코드당 카운트 목록입니다.
오류 오브젝트
이름
데이터 유형
설명
errorCode문자열
Marketo 오류 코드.
count정수
해당 날짜에 오류가 발생한 횟수입니다.
참고
각 API 사용자는 사용 응답에서 개별적으로 보고됩니다. 개별 API 사용자 간에 통합을 분할하면 할당량을 소모하고 오류가 발생하는 서비스를 보다 쉽게 식별할 수 있습니다.
recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59