등기고 API

curl -X GET "https://deunggigo.kr/api/v1/credits/balance" \
  -H "Authorization: Bearer dgg_xxx"

{
  "creditBalance": 15000
}

curl -X GET "https://deunggigo.kr/api/v1/credits/transactions?page=1&limit=10" \
  -H "Authorization: Bearer dgg_xxx"

{
  "items": [
    {
      "id": "tx_abc123",
      "type": "usage",
      "amount": -50,
      "balanceAfter": 14950,
      "description": "등기부등본 열람 (1341-2004-008457)",
      "referenceType": "inquiry",
      "createdAt": "2024-06-01T09:01:24.000Z"
    },
    {
      "id": "tx_abc124",
      "type": "charge",
      "amount": 10000,
      "balanceAfter": 15000,
      "description": "크레딧 충전",
      "referenceType": "payment",
      "createdAt": "2024-06-01T08:00:00.000Z"
    }
  ],
  "total": 42,
  "page": 1,
  "totalPages": 5
}

{
  "address": "서울 강남구 테헤란로 123",
  "kindCls": "0",
  "page": 1,
  "pageSize": 50
}

{
  "items": [
    {
      "uniqueNo": "1168-2024-001234",
      "address": "서울특별시 강남구 테헤란로 123",
      "propertyType": "집합건물",
      "dong": "101동",
      "ho": "501호"
    }
  ],
  "total": 15
}

{
  "uniqueNo": "1341-2004-008457"
}

{
  "uniqueNo": "1341-2004-008457",
  "address": "경기도 성남시 분당구 ...",
  "propertyType": "집합건물"
}

{
  "swrd": "당찬아이들",
  "srchCls": "PC01",
  "corpClsCd": "0",
  "crgbkStcd": "0",
  "hdbrcCls": "0"
}

{
  "success": true,
  "totalCount": 1,
  "results": [
    {
      "conm": "당찬아이들",
      "romConm": "DangChan Co.,Ltd.",
      "drokno": "111111-1111111",
      "corpClsName": "주식회사",
      "crgbkStcdName": "살아있는 등기",
      "regtName": "수원지방법원 안양지원 안양등기소",
      "masterNo": 1111111,
      "crgNo": "1111111"
    }
  ]
}

{
  "rows": [
    { "drokno": "134111-0071315", "conm": "당찬아이들" }
  ],
  "boxName": "내 법인 문서함"
}

{
  "message": "법인 문서함에 1건 추가되었습니다.",
  "bulkId": "…",
  "added": 1,
  "duplicated": 0
}

{
  "row": { "drokno": "134111-0071315", "conm": "당찬아이들" },
  "execute": true,
  "issueType": "1"
}

{
  "message": "법인등기 열람 요청이 접수되었습니다.",
  "inquiryId": "…",
  "inquiry": { "id": "…", "uniqueNumber": "134111-0071315", "status": "pending", "cost": 1700, "bulkId": "…" },
  "bulkId": "…"
}

{
  "inquiryIds": ["…"],
  "issueType": "1"
}

{
  "success": true,
  "message": "법인등기 1건 열람을 시작했습니다.",
  "bulkId": "…",
  "paidCount": 1,
  "creditDeducted": 1700
}

{
  "items": [
    {
      "id": "bulk_clxyz1234",
      "fileName": "강남구_조회.xlsx",
      "totalCount": 50,
      "completedCount": 48,
      "failedCount": 2,
      "status": "completed",
      "createdAt": "2024-06-01T09:00:00.000Z"
    }
  ],
  "total": 5,
  "page": 1,
  "totalPages": 1
}

{
  "bulkId": "bulk_clxyz1234",
  "items": [
    { "uniqueNo": "13412004008457", "address": "경기도 성남시 ...", "kindCls": "1" },
    { "uniqueNo": "1168-2024-001234", "address": "서울특별시 강남구 ...", "kindCls": "1" }
  ]
}

{
  "boxName": "강남구 조회",
  "items": [
    { "uniqueNo": "13412004008457", "address": "경기도 성남시 ...", "kindCls": "1" }
  ]
}

{
  "success": true,
  "bulkId": "bulk_clxyz1234",
  "count": 2
}

{
  "bulkInquiry": {
    "id": "bulk_clxyz1234",
    "fileName": "강남구_조회.xlsx",
    "totalCount": 50,
    "completedCount": 48,
    "failedCount": 2,
    "status": "completed",
    "totalCost": 4800
  },
  "items": [
    {
      "id": "clxyz1111",
      "uniqueNumber": "1341-2004-008457",
      "status": "completed",
      "cost": 100,
      "hasPdf": true,
      "createdAt": "2024-06-01T09:00:00.000Z"
    }
  ]
}

{
  "name": "강남구 2024년 2분기"
}

{
  "message": "문서함이 수정되었습니다."
}

{
  "message": "문서함이 삭제되었습니다."
}

{
  "message": "일괄 열람이 시작되었습니다.",
  "totalCount": 50,
  "creditDeducted": 2500
}

{
  "issueType": "1",
  "searchDiv": "1",
  "uniqueNo": "1341-2004-008457",
  "display": "2"
}

{
  "message": "조회 요청이 접수되었습니다.",
  "inquiry": {
    "id": "clxyz1234abcd",
    "uniqueNumber": "1341-2004-008457",
    "issueType": "1",
    "status": "pending",
    "cost": 50,
    "bulkId": "b1a2c3d4-..."
  }
}

{
  "error": "크레딧이 부족합니다. 필요: 50원, 현재: 0원"
}

{
  "error": "지정한 문서함을 찾을 수 없습니다. (bulkId 확인)"
}

{
  "error": "동일한 등기부등본이 이미 처리 중입니다."
}

{
  "inquiry": {
    "id": "clxyz1234abcd",
    "uniqueNumber": "1341-2004-008457",
    "propertyType": "building",
    "issueType": "1",
    "status": "completed",
    "cost": 50,
    "pdfPath": "/downloads/registry_clxyz1234abcd.pdf",
    "parsedData": {
      "title_section": [...],
      "exclusive_building": [...],
      "section_a": [...],
      "section_b": [...]
    },
    "createdAt": "2024-06-01T09:00:00.000Z",
    "completedAt": "2024-06-01T09:01:24.000Z"
  }
}

{
  "items": [
    {
      "id": "alert_abc123",
      "uniqueNumber": "1341-2004-008457",
      "address": "경기도 성남시 분당구 ...",
      "propertyType": "building",
      "ownerName": "홍길동",
      "isActive": true,
      "createdAt": "2024-06-01T09:00:00.000Z",
      "recipients": [
        { "name": "담당자", "phone": "010-1234-5678" }
      ]
    }
  ],
  "total": 10,
  "page": 1,
  "totalPages": 1
}

{
  "uniqueNumber": "1341-2004-008457",
  "address": "경기도 성남시 분당구 ...",
  "propertyType": "building",
  "ownerName": "홍길동",
  "recipients": [
    { "name": "담당자", "phone": "010-1234-5678" }
  ]
}

{
  "message": "알림이 등록되었습니다.",
  "alert": {
    "id": "alert_abc123",
    "uniqueNumber": "1341-2004-008457",
    "isActive": true,
    "recipients": [
      { "name": "담당자", "phone": "010-1234-5678" }
    ]
  }
}

{
  "error": "크레딧이 부족합니다."
}

{
  "error": "이미 등록된 부동산입니다."
}

{
  "isActive": true
}

{
  "recipients": [
    { "name": "담당자A", "phone": "010-1111-2222" },
    { "name": "담당자B", "phone": "010-3333-4444" }
  ]
}

{
  "id": "alert_abc123",
  "uniqueNumber": "1341-2004-008457",
  "isActive": true,
  "recipients": [
    { "name": "담당자A", "phone": "010-1111-2222" },
    { "name": "담당자B", "phone": "010-3333-4444" }
  ]
}

{
  "message": "알림이 삭제되었습니다."
}

curl -X GET "https://deunggigo.kr/api/v1/alerts/owner-name?uniqueNumber=1341-2004-008457" \
  -H "Authorization: Bearer dgg_xxx"

{
  "ownerName": "홍길동"
}

{
  "webhook": { "id": "wh_...", "url": "https://example.com/webhook", "events": ["alert.detected"], "isActive": true }
}