서버 조회와 CSV 내보내기

​

자원별 경로

​

모르는 조건을 다루는 방식

​

검색 응답

curl -sS "https://meterengine.com/v1/invoices/draft/search?month=2026-10&min_amount=10000&page=1&size=50" \
  -H "Authorization: Bearer me_test_xxxxxxxx"

const params = new URLSearchParams({ month: "2026-10", min_amount: "10000", page: "1", size: "50" });
const response = await fetch(`https://meterengine.com/v1/invoices/draft/search?${params}`, {
  headers: { Authorization: "Bearer me_test_xxxxxxxx" },
});
const { items, total, page, size } = await response.json();
const hasNext = page * size < total;

​

CSV 내보내기

curl -sS -o invoices-2026-10.csv \
  "https://meterengine.com/v1/invoices/export?month=2026-10" \
  -H "Authorization: Bearer me_test_xxxxxxxx"

const response = await fetch("https://meterengine.com/v1/invoices/export?month=2026-10", {
  headers: { Authorization: "Bearer me_test_xxxxxxxx" },
});
if (!response.ok) throw new Error((await response.json()).code);
// text()는 UTF-8로 읽으면서 첫 BOM을 뗀다.
const csv = await response.text();

{
  "code": "validation_error",
  "message": "요청 값이 올바르지 않습니다",
  "errors": [
    { "field": "export", "message": "10000행 이하가 되도록 검색 범위를 좁혀 주세요" }
  ]
}

​

파일 형식

• 응답의 Content-Type은 text/csv;charset=UTF-8이고 Content-Disposition에 파일 이름(customers.csv, billable-metrics.csv, billable-metric-prices.csv, usage.csv, draft-invoices.csv, invoices.csv, events.csv)이 붙습니다.
• 파일은 UTF-8 BOM으로 시작하고 줄 끝은 CRLF입니다. 프로그램으로 읽을 때는 첫 BOM 문자를 떼고 읽으세요.
• 모든 칸을 큰따옴표로 감쌉니다. 값 안의 큰따옴표는 두 번 겹쳐 씁니다.
• 결과가 없어도 열 제목 줄은 나옵니다.

​

검색 결과 CSV의 열

• 안쪽 객체는 점으로 이어 붙인 이름의 열이 됩니다. 인보이스 CSV는 invoice.invoice_number, invoice.total_amount, payment.status처럼 나옵니다.
• 배열은 한 칸에 JSON 문자열로 들어갑니다. 인보이스의 invoice.lines, 청구 예정액의 lines, 사용량의 metrics가 그렇습니다.
• 사용량과 청구 예정액 CSV는 한 행이 고객 하나입니다.

​

이벤트 CSV

curl -sS -o events-2026-10.csv \
  "https://meterengine.com/v1/events/export?month=2026-10&sort=received_at&order=desc&include_properties=true" \
  -H "Authorization: Bearer me_test_xxxxxxxx"

​

콘솔에서 내려받기

​

자기 기록과 맞추기