"코딩은 4시간인데 연동에 4주 걸림"… 개발자 뒷목 잡게 한 최악의 API 모음

요약 미국의 한 테크 스타트업 개발자가 고객 온보딩 자동화 작업을 진행하면서 겪은 온갖 엉터리 API 연동 경험을 토로해 개발자 커뮤니티에서 공감을 사고 있습니다. 계약 체결, 전자서명, 청구서 발행, CRM, 카드 결제 대행 등 다양한 외부 솔루션 API를 연동했는데, 나온 지 10년도 넘은 서비스들이 기본적인 개발자 경험조차 갖추지 못했다는 지적입니다. 글쓴이가 꼽은 대표적인 문제는 문서 열람 제한(Gated documentation)이었습니다. 문서를 보려면 회원가입을 하거나 문의 메일을 보내 며칠씩 기다려야 하는 황당한 구조였는데, 담당 팀에 항의하자 '영업 리드 추적용'이라는 황당한 답변이 돌아왔다고 합니다. 이미 유료 고객인데도 문서를 막아둔 탓에, AI 에이전트로 문서를 읽혀 연동 코드를 짜려던 작업 흐름까지 완전히 깨졌습니다. 여기에 15년이나 된 OpenAPI 스펙도 제공하지 않아 직접 클라이언트를 작성해야 하거나, API 키 발급조차 셀프 서비스가 안 돼 지원 티켓을 넣고 며칠씩 기다려야 하는 문제도 있었습니다. 심지어 API 키가 개인 계정에 종속되어 담당자가 휴가를 가거나 퇴사하면 시스템이 마비되는 구조도 존재했습니다. 웹훅 연동 시 보안용 시크릿 키를 받기 전에 엔드포인트 응답부터 요구하는 기형적인 검증 절차 때문에 더미 서버로 우회해야 하는 촌극까지 벌어졌습니다. 작성자는 코드 작성 자체는 AI 에이전트로 4시간 만에 끝났지만, 키 발급 대기나 엉망인 연동 절차 때문에 4주나 걸렸다며 분통을 터뜨렸습니다. 특히 결제 관련 기업들을 향해 "15년 전부터 잘 만들어진 스트라이프(Stripe) API가 있으니 제발 베끼기라도 하라"고 일침을 가했습니다.