<h1>공고 알림봇 만들기 (3편) — 목록에 없는 API를 직접 찾아냈습니다</h1>

2편에서 인증키가 네 갈래라고 했죠. 그런데 든든전세는 키를 받고 나서도 막혔어요. 보낼 주소를 몰랐거든요.

지난 편 → 2편 — 인증키가 필요 없는 공공 API도 있습니다

목록엔 있는데 명세가 없었어요

시작할 때 조사 노트에 이렇게 적어뒀었어요. "든든전세 모집공고, 공공데이터포털에 등록돼 있음. 자동승인이라 신청하면 바로 됨."

절반만 맞았어요.

포털에 목록은 분명히 있습니다. 그런데 들어가 보면 "이런 데이터가 있습니다" 하고 기관 사이트로 넘기는 형태였어요. 정작 개발자한테 필요한 건 그다음인데 말이죠.

이게 없으면 키가 있어도 아무것도 못 해요. "데이터가 존재한다"와 "데이터를 가져올 수 있다"는 다른 얘기였습니다.

그날 오후까지도 못 찾았어요. 작업 기록에 이렇게 남아 있습니다.

HUG 든든전세 — 엔드포인트 자체를 아직 못 찾은 상태

이때 이미 다른 세 곳은 돌아가고 있었어요. K-Startup도, LH도, 마이홈도 알림이 오고 있었죠. 든든전세 하나만 안 됐습니다. 하필 제일 중요한 거였고요.

밤이 되어서야 붙였어요. 반나절을 주소 하나 찾는 데 쓴 거죠. 코드를 짠 시간보다 "어디로 보내야 하나"를 알아내는 시간이 훨씬 길었어요.

찾고 보니 주소는 공개 페이지들과 아예 다른 자리에 있었어요. 안내 페이지가 /jeonse/web/... 아래 모여 있는데, 실제 API는 사이트 최상단에 따로 있더라고요. 문서 링크만 따라가서는 닿을 수 없는 곳이었습니다.

주소를 찾았으니 끝인 줄 알았죠. 아니었어요.

든든전세는 수시 모집이라 공고가 없는 기간이 꽤 깁니다. 그때 응답이 이렇게 와요.

[{"ERROR_CODE": "03", "ERROR_MSG": "NO_DATA"}]

빈 배열 []이 아니라, 에러처럼 생긴 걸 한 건 담아서 줍니다.

이걸 그냥 받으면 두 가지가 터져요. 공고가 없을 뿐인데 프로그램이 "에러 났다"고 판단해서 로그가 에러로 도배되고, 저 객체를 공고 한 건으로 착각해서 "NO_DATA 공고가 떴습니다" 같은 알림이 폰으로 날아옵니다.

그래서 ERROR_CODE가 03이면 "에러가 아니라 정상적으로 공고가 없는 상태" 로 따로 처리하게 했어요. 실제로 지금까지 이 응답이 257번 왔습니다. 그때마다 조용히 넘어갑니다.

마지막 복병이 있었어요. 이 API가 주는 필드는 아홉 개인데, 그중에 상세 페이지 주소가 없습니다.

공고일, 접수 시작·종료, 지역, 동 주소, 주택 유형, 전용면적, 보증금. 물건 정보는 다 주는데 "이 물건 보러 가는 링크"만 없어요.

없는 게 아니라 못 만드는 거였어요. 든든전세 조회 페이지는 지역·면적·보증금으로 걸러 보는 방식이라, 물건 하나를 딱 가리키는 고유 주소가 애초에 존재하지 않습니다.

	보통의 공고 API	든든전세
상세 링크	공고마다 고유 주소	없음
알림에서 할 수 있는 것	눌러서 바로 이동	조회 페이지로 보내고 직접 찾기

그래서 알림엔 조회 페이지 주소를 고정으로 넣고, 대신 동 주소·면적·보증금을 본문에 실어서 가서 바로 찾을 수 있게 했어요. 완벽하진 않지만 이게 최선이었습니다.

이 편에서 막힌 세 곳은 전부 같은 성격이었어요. 문서엔 없고 실제 응답에만 있는 것들.

주소도, 공고 없을 때의 규칙도, 상세 링크가 없다는 사실도 — 어디에도 안 적혀 있었어요. 한 번 호출해보고 나서야 알았죠.

그래서 소스를 붙일 때 순서가 바뀌었어요. 문서를 끝까지 읽고 짜는 게 아니라, 일단 한 번 던져보고 돌아온 걸 보면서 짭니다. 2편에서 K-Startup을 "그냥 호출해봤더니 되더라"고 했는데, 그게 요령이 아니라 이 바닥의 기본기였던 거예요.

주소도 찾고 응답도 받았는데, 이번엔 그 응답들이 서로 안 닮았어요. 표준을 따르는 줄 알았던 API가 내놓은 뜻밖의 구조. → 4편 — API마다 응답 구조가 달랐습니다