Hycore Works — API·JSON 검증 예제와 작업 소개 사이트

프로젝트 개요

API 응답과 JSON 데이터의 검사 기준을 정하고, 같은 입력으로 결과를 다시 확인할 수 있도록 만든 자체 시연 프로젝트입니다. Hycore Works는 이 작업을 소개하는 프로젝트 이름입니다. 고객 납품 사례나 등록된 회사 실적으로 소개하지 않습니다.

소개 사이트는 HTML/CSS로 구성한 정적 페이지이며 Cloudflare Pages에서 제공합니다. 검증 코드는 별도의 로컬 환경에서 실행했습니다. 웹사이트가 방문자의 파일이나 API 키를 받아 검사하는 온라인 서비스는 아닙니다.

1. n8n API 응답 검증

정해진 응답 규칙과 합성 입력 9개로 워크플로 변경 전후를 비교했습니다. n8n 2.44.5의 실제 로컬 실행 기록에서 변경 전 2/9, 변경 후 9/9 사례가 검사 기준을 통과했습니다. 이 수치는 공개한 예제 입력의 결과이며 실제 고객 환경의 성능이나 모든 오류의 해결을 의미하지 않습니다.

워크플로, 검사 코드, 입력 조건과 실행 결과: https://gist.github.com/hycore220/0ad1ae0b0bf8c220eaed21870f657ccb

2. COCO detection JSON 구조 검사

Python으로 COCO detection JSON의 일부 구조와 필드 조건을 검사하는 도구를 만들었습니다. 잘못된 합성 예제에서는 오류 5개를 보고했고, 허용한 부분집합 예제에서는 구조 오류가 없었습니다. 공개한 검증 기록에는 단위 테스트 20개가 통과했습니다. 이미지 내용이나 라벨의 시각적 정확도를 판정하는 도구는 아닙니다.

검사 소스, 합성 입력과 결과: https://gist.github.com/hycore220/63a3a77fe37bb6adde48449a02d6c9fc

작업에서 정리한 점

검사 대상, 정상·오류 입력, 기대 결과와 재실행 방법을 함께 남겼습니다. 결과 보고서에는 확인한 범위와 확인하지 못한 범위를 구분했습니다. 공개 예제에는 고객 자료나 운영 비밀키를 사용하지 않았습니다.