MIJI DApp Server Docs

Admin API Guide

어드민 대시보드 전용 API입니다. 모든 엔드포인트는 x-admin-secret-key 헤더로 인증합니다. 기업별 응답 차이가 없으므로 x-api-key, x-corporate-id는 필요하지 않습니다.

공통 헤더

Name	Required	Value
x-admin-secret-key	✅	내부 어드민 시크릿 키

---

GET /admin/recent-activity

최근 활동(민팅 주문 + 웹훅 로그)을 조회합니다. updatedAt 내림차순, limit=30 고정이며 offset으로 페이징합니다.

• Query
  • offset (number, optional, default 0): 30 단위 페이지 오프셋
• 정렬/제한
  • 정렬: updatedAt DESC
  • 제한: limit=30 고정
• 응답 예시

  {
  "items": [
    {
      "type": "mintingOrder",
      "id": "6950123...",
      "status": "COMPLETED",
      "updatedAt": "2025-12-30T08:10:11.123Z",
      "payload": {
        "receiverAddress": "0x...",
        "tokenId": "1",
        "mode": "direct"
      }
    },
    {
      "type": "webhookLog",
      "id": "6950456...",
      "status": "SUCCESS",
      "updatedAt": "2025-12-30T08:07:42.011Z",
      "payload": {
        "event": "mint.completed",
        "targetUrl": "https://..."
      }
    }
  ],
  "offset": 0,
  "limit": 30,
  "total": 30
  }
  

cURL 예시

curl -X GET "https://dev.asset.cccv.to/admin/recent-activity?offset=0" \
  -H "accept: application/json" \
  -H "x-admin-secret-key: <ADMIN_SECRET_KEY>"

---

GET /status (어드민 인증)

서비스 상태/큐 지표를 조회합니다. 헬스체크(/health)와 달리 인증이 필요합니다. (인증 스키마가 x-admin-secret-key로 변경되었습니다.)

cURL 예시

curl -X GET "https://dev.asset.cccv.to/status" \
  -H "accept: application/json" \
  -H "x-admin-secret-key: <ADMIN_SECRET_KEY>"

헬스체크용 공개 엔드포인트는 /health(헤더 불필요) 입니다.