고객 단위 사용량 검색과 서버 페이지 조회
curl --request GET \
--url https://meterengine.com/v1/usage/search \
--header 'Authorization: Bearer <token>'const url = 'https://meterengine.com/v1/usage/search';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"items": [
{
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"customer_name": "<string>",
"metrics": [
{
"aggregation": "<string>",
"code": "<string>",
"customers": [
{
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"customer_name": "<string>",
"dimension_usages": [
{
"dimension_values": {},
"quantity": 123,
"raw_quantity": 123,
"raw_quantity_denominator": 123,
"raw_quantity_numerator": 123
}
],
"quantity": 123,
"raw_quantity": 123,
"raw_quantity_denominator": 123,
"raw_quantity_numerator": 123
}
],
"event_type": "<string>",
"name": "<string>",
"percentile": 123,
"rounding_mode": "<string>",
"rounding_precision": 123,
"target_property": "<string>",
"unit_size": 123
}
]
}
],
"page": 123,
"size": 123,
"summary": {},
"total": 123,
"total_unfiltered": 123
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}검색과 내보내기
고객 단위 사용량 검색과 서버 페이지 조회
month, customer_id, billable_metric_code, q, status(고객 보관 상태, 기본 all), sort(customer_name/customer_id/line_count), order, page, size를 받는다. 한 고객의 모든 미터를 같은 페이지에 둔다. summary는 month, customer_count, metric_count, line_count, nonzero_customer_count다.
GET
/
v1
/
usage
/
search
고객 단위 사용량 검색과 서버 페이지 조회
curl --request GET \
--url https://meterengine.com/v1/usage/search \
--header 'Authorization: Bearer <token>'const url = 'https://meterengine.com/v1/usage/search';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"items": [
{
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"customer_name": "<string>",
"metrics": [
{
"aggregation": "<string>",
"code": "<string>",
"customers": [
{
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"customer_name": "<string>",
"dimension_usages": [
{
"dimension_values": {},
"quantity": 123,
"raw_quantity": 123,
"raw_quantity_denominator": 123,
"raw_quantity_numerator": 123
}
],
"quantity": 123,
"raw_quantity": 123,
"raw_quantity_denominator": 123,
"raw_quantity_numerator": 123
}
],
"event_type": "<string>",
"name": "<string>",
"percentile": 123,
"rounding_mode": "<string>",
"rounding_precision": 123,
"target_property": "<string>",
"unit_size": 123
}
]
}
],
"page": 123,
"size": 123,
"summary": {},
"total": 123,
"total_unfiltered": 123
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}{
"code": "validation_error",
"message": "서버 내부 오류입니다",
"errors": [
{
"field": "event_type",
"message": "공백일 수 없습니다"
}
]
}인증
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
쿼리 매개변수
Maximum string length:
2000Maximum string length:
2000사용 가능한 옵션:
asc, desc 필수 범위:
1 <= x <= 2147483647필수 범위:
1 <= x <= 200Maximum string length:
2000Pattern:
^[0-9]{4}-(0[1-9]|1[0-2])$예시:
"2026-08"
Maximum string length:
2000