Vom 21YunBox China Engineering-Team · Veröffentlicht 1. Juli 2020

Willkommen bei der API der Dienste zur Erkennung unzulässiger Informationen. Diese API hilft Ihnen, Ihre Inhalte für China zu bereinigen.

API-Basis-URL

Ihr Account Manager stellt Ihnen eine Basis-URL bereit. Verwenden Sie diese Basis-URL zusammen mit den unten beschriebenen Endpunkten, um auf die Authentifizierungsdienste zuzugreifen.


Endpunkt: /detect

Verwenden Sie diese API, um unzulässige Informationen in Ihren Inhalten zu erkennen und herauszufiltern. Es wird bereinigter Inhalt zurückgegeben, wobei erkannte unzulässige Informationen durch * ersetzt werden.

Request:

  • HTTP-Methode: POST
  • Request-Format: JSON

Beispiel-Request-JSON:

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

Beispiele

Erfolgreiche Anfrage mit bereinigtem Inhalt

Request-JSON:

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

Response-JSON:

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

Erfolgreiche Anfrage mit erkannten unzulässigen Informationen

Request-JSON:

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

Response-JSON:

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

Struktur der Fehler-Response

JSON-Struktur der Fehler-Response:

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

Felder

  • key: Ihr API-Schlüssel, zugewiesen von Ihrem Account Manager.

  • content: Der Textinhalt, der auf unzulässige Informationen verarbeitet werden soll.

  • bad_words: Eine Liste der im content erkannten sensiblen Wörter. Ist diese Liste leer, wurden keine sensiblen Wörter gefunden. Ist sie nicht leer, so werden diese Wörter im clean_content durch * ersetzt.

  • status: Gibt „ok“ zurück, wenn die Anfrage erfolgreich ist.

  • clean_content: Der bereinigte Inhalt nach der Verarbeitung unzulässiger Informationen.

  • code: Ein Fehlercode, der bei fehlgeschlagener Anfrage zurückgegeben wird. Siehe die Liste unten für die Bedeutung der Codes.

  • msg: Eine kurze Fehlermeldung, die bei fehlgeschlagener Anfrage zurückgegeben wird. Siehe die Liste unten für die Beschreibungen der Meldungen.

Fehlercodes und Definitionen

  • 0070: Request-Format ist nicht JSON.
  • 0072: Fehlende Argumente phone_no oder key im JSON.
  • 0073: Ungültiger Schlüssel. Kontaktieren Sie Ihren Account Manager, um einen gültigen API-Schlüssel zu erhalten.

Melden Sie sich gerne, wenn Sie weitere Fragen haben oder Unterstützung benötigen.

21YunBox ausprobieren?

Beratung anfragen