유해 정보 탐지 서비스 API 문서

유해 정보 탐지 서비스 API에 오신 것을 환영합니다. 이 API는 중국을 위해 콘텐츠를 정화하는 데 도움을 줍니다.

API 기본 URL

담당 계정 매니저가 기본 URL을 제공해 드립니다. 이 기본 URL과 아래 설명된 엔드포인트를 함께 사용하여 인증 서비스에 접근하세요.

엔드포인트: /detect

이 API를 사용하여 콘텐츠에서 유해 정보를 탐지·필터링하세요. 탐지된 유해 정보가 *로 대체된 정화된 콘텐츠가 반환됩니다.

요청:

• HTTP 메서드: POST
• 요청 형식: JSON

요청 JSON 예시:

{
    "key": "<API_KEY>",
    "content": "<TEXT>"
}

예시

정상 콘텐츠로 성공한 요청

요청 JSON:

{
    "key": "<API_KEY>",
    "content": "你好"
}

응답 JSON:

{
    "bad_words": [],
    "clean_content": "你好",
    "status": "ok"
}

유해 정보가 탐지된 성공한 요청

요청 JSON:

{
    "key": "<API_KEY>",
    "content": "8月6日，此前在抗洪抢险过程中遇险失联的舒兰市委常委、常务副市长骆旭东等3名公职人员被找到，已无生命体征，因公牺牲。随后，骆旭东等人乘坐的车辆在开原镇新开村东侧被打捞上岸。8月9日，记者来到车辆被打捞地，银白色的车辆被洪水冲刷变形，满布淤泥。"
}

응답 JSON:

{
    "bad_words": [
        {
            "word": "常委"
        },
        {
            "word": "市长"
        },
        {
            "word": "受灾"
        },
        {
            "word": "共产党"
        }
    ],
    "clean_content": "8月6日，此前在抗洪抢险过程中遇险失联的舒兰市委*、常务副*骆旭东等3名公职人员被找到，已无生命体征，因公牺牲。随后，骆旭东等人乘坐的车辆在开原镇新开村东侧被打捞上岸。8月9日，记者来到车辆被打捞地，银白色的车辆被洪水冲刷变形，满布淤泥。",
    "status": "ok"
}

실패 응답 구조

실패 응답 JSON 구조:

{
    "code": "<ERROR CODE>",
    "msg": "<MESSAGE>"
}

필드

• key: 담당 계정 매니저가 배정한 API 키.

• content: 유해 정보 처리를 위한 텍스트 콘텐츠.

• bad_words: content에서 탐지된 민감 단어 목록. 비어 있으면 민감 단어가 없는 것이고, 비어 있지 않으면 해당 단어가 clean_content에서 *로 대체됩니다.

• status: 요청이 성공하면 “ok”를 반환.

• clean_content: 유해 정보 처리 후 정화된 콘텐츠.

• code: 요청 실패 시 반환되는 오류 코드. 아래 목록에서 코드의 의미를 참고하세요.

• msg: 요청 실패 시 반환되는 짧은 오류 메시지. 아래 목록에서 메시지 설명을 참고하세요.

오류 코드와 정의

• 0070: 요청 형식이 JSON이 아님.
• 0072: JSON에 phone_no 또는 key 인수 누락.
• 0073: 유효하지 않은 키. 유효한 API 키를 받으려면 담당 계정 매니저에게 문의.

추가 질문이나 도움이 필요하면 언제든 문의해 주세요.