API 가이드

https://deunggigo.kr/api/v1

# 방법 1 — Authorization Bearer
Authorization: Bearer dgg_xxxxxxxxxxxxxxxx

# 방법 2 — X-Api-Key
X-Api-Key: dgg_xxxxxxxxxxxxxxxx

POST /api/v1/inquiries
Authorization: Bearer dgg_xxxxxxxxxxxxxxxx
Content-Type: application/json

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

POST /api/v1/inquiries
Authorization: Bearer dgg_xxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "issueType": "1",
  "searchDiv": "1",
  "uniqueNo": "1341-2004-008457",
  "display": "2",
  "irosId": "my_iros_id",
  "irosPw": "my_iros_password",
  "ecashNo": "123456789",
  "ecashPw": "my_ecash_password"
}

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

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

{
  "error": "인터넷등기소 및 전자민원캐시 계정 정보가 필요합니다. 설정 페이지에서 등록하거나 요청 body에 irosId/irosPw/ecashNo/ecashPw를 포함해주세요."
}

{ "error": "인증이 필요합니다." }

{ "error": "동일한 등기부등본이 이미 처리 중입니다. 잠시 후 다시 시도해주세요." }

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

{
  "inquiry": {
    "id": "clxyz1234abcd",
    "status": "failed",
    "pdfPath": null,
    "parsedData": null,
    "errorMessage": "전자민원캐시 비밀번호가 잘못되었습니다",
    "createdAt": "2024-06-01T09:00:00.000Z",
    "completedAt": null
  }
}

{
  "items": [
    {
      "id": "clxyz1234abcd",
      "uniqueNumber": "1341-2004-008457",
      "propertyType": "building",
      "issueType": "1",
      "status": "completed",
      "cost": 50,
      "createdAt": "2024-06-01T09:00:00.000Z"
    }
  ],
  "total": 142,
  "page": 1,
  "totalPages": 8
}

POST /api/v1/bulk-inquiries
Authorization: Bearer dgg_xxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "projectId": "proj_clxyz1234",   // (선택) 프로젝트에 소속시킬 경우
  "items": [
    {
      "searchDiv": "1",
      "issueType": "1",
      "uniqueNo": "1341-2004-008457",
      "display": "2"
    },
    {
      "searchDiv": "4",
      "issueType": "0",
      "rdAdminRegn1": "서울특별시",
      "rdAdminRegn2": "강남구",
      "rdName": "테헤란로",
      "rdBuldNo": "123",
      "rdKindCls": "1"
    }
  ],
  "irosId": "my_iros_id",
  "irosPw": "my_iros_password",
  "ecashNo": "123456789",
  "ecashPw": "my_ecash_password"
}

POST /api/v1/bulk-inquiries
Cookie: <session>
Content-Type: multipart/form-data; boundary=----...

------...
Content-Disposition: form-data; name="file"; filename="bulk.xlsx"
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

(엑셀 바이너리)
------...--

{
  "message": "대량 조회가 시작되었습니다.",
  "bulkInquiry": {
    "id": "bulk_clxyz1234",
    "totalCount": 2,
    "skippedCount": 0,
    "batchDuplicateCount": 0,
    "creditDeducted": 0,
    "quotaConsumed": { "view": 1, "print": 0 },
    "postpaidIncrement": { "view": 0, "print": 1 }
  },
  "items": [
    {
      "id": "clxyz1111",
      "uniqueNumber": "1341-2004-008457",
      "issueType": "1",
      "searchDiv": "1",
      "billingType": "subscription_quota",
      "cost": 0,
      "status": "pending"
    },
    {
      "id": "clxyz2222",
      "uniqueNumber": "서울특별시 강남구 테헤란로 123",
      "issueType": "0",
      "searchDiv": "4",
      "billingType": "subscription_postpaid",
      "cost": 200,
      "status": "pending"
    }
  ]
}

{ "error": "요청 body에 items 배열이 필요합니다 (각 항목은 단건 조회 파라미터와 동일)." }

{
  "error": "한 번에 요청 가능한 최대 항목 수는 10,000건입니다. 현재: 12,500건",
  "maxItems": 10000,
  "received": 12500
}

{ "error": "유효한 조회 항목이 없습니다. 필수 필드를 확인해주세요." }

{
  "error": "미정산된 초과 요금이 있어 서비스를 이용할 수 없습니다. 결제 후 다시 이용해주세요. 미정산 금액: 5,000원",
  "unpaidOverageAmount": 5000
}

{ "error": "해지된 구독은 쿼터 초과 후불이 불가합니다. 크레딧을 충전해주세요. 필요: 100원, 잔액: 0원" }

{ "error": "모든 항목이 이미 처리 중입니다. 잠시 후 다시 시도해주세요." }

{
  "items": [
    {
      "id": "bulk_clxyz1234",
      "fileName": "bulk.xlsx",
      "totalCount": 2,
      "completedCount": 1,
      "failedCount": 0,
      "status": "processing",
      "createdAt": "2024-06-01T09:00:00.000Z"
    }
  ],
  "total": 5,
  "page": 1,
  "totalPages": 1
}