B2B 대조 API

구매대행 솔루션·도매몰·위탁 플랫폼이 상품 목록을 보내면, 식약처·국표원·공정위(소비자24)의 리콜·회수 공표와 대조한 결과를 상품별로 돌려 드립니다. 공표 원문 목록 자체는 제공하지 않습니다.

요청

POST /api/v1/check · 한 번에 상품 1,000개까지 · 분당 60회까지. name 만 필수이고, 번호를 많이 보낼수록 정확합니다.

curl -X POST https://recallguard.netizenkorea.kr/api/v1/check \
  -H "Authorization: Bearer rg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "id": "SKU-1001", "name": "무선 미니 선풍기", "barcode": "8800317062317",
        "model_no": "VDT-E05W", "maker": "워로브라더스", "kc_cert_no": "ZU07564-25001" },
      { "id": "SKU-1002", "name": "유아 목욕의자", "model_no": "MY002", "maker": "ONTHEWEI" }
    ]
  }'

응답

verdict: match	바코드·품목제조보고번호·KC인증번호가 같거나, 모델명과 제조사가 같음
verdict: review	모델명만 같거나 상품명이 비슷함 — 사람이 확인해야 함
verdict: none	현재 공개된 목록과 일치하는 항목 없음 (안전 보증 아님)
hits[].matched	어떤 번호가 일치했는지
hits[].notice.overseas	해외 기관 공표 (국내 조치 전일 수 있음)

{
  "checked_at": "2026-10-14T06:10:00.000Z",
  "notices_updated_at": "2026-10-14T05:00:04.351Z",
  "items": 2,
  "matched": 2,
  "results": [
    {
      "id": "SKU-1001",
      "verdict": "match",
      "hits": [
        {
          "stage": 1, "score": 100, "rule": "바코드 일치",
          "matched": [{ "field": "바코드", "value": "8800317062317" }],
          "notice": {
            "source": "국가기술표준원 · 소비자24 공산품", "also_in": ["국표원 제품안전정보센터"],
            "published_at": "2026-07-23", "product_name": "전기차 충전기(전기차 충전기)",
            "maker": "주식회사 워로브라더스(WoloBrothers)", "reason": "…", "overseas": false
          }
        }
      ]
    }
  ],
  "disclaimer": "공개된 리콜·회수 공표와의 대조 결과이며 상품의 안전성을 보증하지 않습니다. …"
}

오류

400 — 본문 형식 오류, items 비었음, 1,000개 초과, name 없음
401 — 키 없음·틀림·폐기됨
429 — 분당 호출 수 또는 월 대조 한도 초과

요금·발급

대조한 상품 1건당 과금하며 단가는 물량에 따라 협의합니다(예: 건당 5~10원). 키 발급·문의는 netizen@netizenkorea.co.kr. 응답을 최종 사용자에게 보여 줄 때는 출처와 ‘안전성을 보증하지 않는다’는 문구를 함께 표시해 주세요.