sayren Docs
Carriers

List

GET
/v1/carriers
AuthorizationBearer <token>

userToken(계정 스코프) 또는 storeToken(스토어 스코프)

In: header

Response Body

application/json

curl -X GET "https://example.com/v1/carriers"
{  "meta": {    "status": 0,    "code": "OK",    "message": "string",    "isSuccess": true  },  "data": [    {      "carrierCode": "string",      "name": "string",      "trackingUrlTemplate": "string"    }  ],  "error": null}

API 로그 요약 GET

최근 24시간(`windowHours`)의 연동 요청 수(`total`)와 그중 4xx·5xx 응답 수(`errors`), 5xx 응답 수(`serverErrors`). 연동 트래픽(호출 주체 `PAT`·`CLIENT`)만 집계하고 콘솔 사용자(`USER`) 요청은 제외한다. 개요 화면 지표용이다. 기록 대상은 이 스토어로 인증된 관리 API(`/v1/**`) 요청이다. OAuth 프로토콜 표면(`/v1/oauth2/*`, `/.well-known/*`)과 API 로그 조회 자체(`/v1/api-logs`)는 기록하지 않는다. 인증 단계에서 거부된 요청(토큰이 없거나 유효하지 않은 401, 토큰 스코프 부족 403)은 스토어를 확정하기 전이라 기록되지 않는다. Authorization·쿠키 헤더와 요청 본문은 저장하지 않고, 민감한 쿼리 값(token·secret·code·password·email·phone·이름·검색어 등)은 `***`로 가린다. 기록은 응답 후 비동기로 쌓여 수 초 늦게 보일 수 있다. 보관 기간은 7일이며 조회도 최근 7일로 한정된다. OWNER/ADMIN이 콘솔에서 로그인한 토큰으로만 조회할 수 있다.

카테고리 목록 조회 GET

쿼리에 따라 응답 형태가 다르다. 스코프 `category:r`. - 기본: `Category[]` — `parentId`의 직계 자식(생략하면 최상위). `flat=true`면 전체를 깊이·순서대로 평탄화한다. - `tree=true`: `CategoryTreeNode[]` — 최상위부터 `children`을 재귀로 채운 트리다. - `q` 지정: `CategorySearchResult[]` — 이름 검색 결과로 `fullPath`·`ancestors`가 붙는다. `q`가 `tree`보다 우선한다. 아래 응답 스키마는 기본 형태다.