Updated on 2023-09-27 GMT+08:00

POST /CCSQM/rest/ccisqm/v1/sentencemanage/updateSentence

Scenario

This interface is invoked to update a sentence.

Method

POST

URI

https://Domain name/apiaccess/CCSQM/rest/ccisqm/v1/sentencemanage/updateSentence (For example, the domain name is service.besclouds.com.)

Request Description

Table 1 Request header parameters

No.

Parameter

Type

Mandatory or Not

Description

1

Content-Type

String

No

The value is fixed to application/json; charset=UTF-8.

2

x-app-key

String

No

App key

3

Authorization

String

Yes

Authentication field. The format is Bearer {Value of AccessToken returned by the tokenByAkSk interface}. (A space is required after Bearer.)

4

x-UserId

String

No

Operator ID

You can sign in to the system and go to the employee management page to view the value of userId returned by an interface.

Table 2 Request body parameters

No.

Parameter

Type

Mandatory or Not

Description

1.1

category_id

String

Yes

Unique ID of a sentence category

1.2

sentence_name

String

Yes

Sentence name

1.3

sentence_id

String

Yes

Sentence ID

1.4

tagDataList

Array [Object]

Yes

Semantics and keywords used in a sentence

1.4.1

tag_type

String

Yes

Tag type

  • keyword: keyword
  • dialogue_act: corpus
  • regular_exp: regular expression

1.4.2

pos_sentences

Array [Object]

No

Positive corpuses, keywords, and regular expressions

1.4.2.1

id

String

No

Unique ID of a corpus

1.4.2.2

name

String

No

Corpus content

1.4.3

neg_sentences

Array [Object]

No

Negative corpuses, which cannot coexist with pos_sentences in one tag object

1.4.3.1

id

String

No

Unique ID of a corpus

1.4.3.2

name

String

No

Corpus content

Response Description

  • Status code: 200
Table 3 Response body parameters

No.

Parameter

Type

Mandatory or Not

Description

1.1

id

String

No

Unique ID of a sentence category

1.2

resultCode

String

No

Return code

  • 0403000: success
  • Others: failure

1.3

resultDesc

String

No

Return description

1.4

statusCode

Number

No

Status code

  • Status code: 400

    Incorrect request. Check the request path and parameters.

  • Status code: 401

    Unauthorized operation. 1. Check whether you have purchased related services. 2. Contact customer service to check the status of your account.

  • Status code: 404

    The requested content is not found. Check the request path.

  • Status code: 500

    Business failure. Check the values of parameters in the request.

Error Codes

None

Example

  • Scenario: Update a sentence.

    Request header:

    x-app-key:************************************  
    X-UserID:1611917095665261978  
    Authorization:Bearer ********************************

    Request parameters:

    {
      "category_id": "1070149256381206528",
      "sentence_name": "Sentence name 766",
      "tagDataList": [
        {
          "tag_type": "dialogue_act",
          "pos_sentences": [
            {
              "name": "11111111111222222222"
            },
            {
              "id": "10162",
              "name": "Synonym corpus 585111111111111111"
            }
          ],
          "neg_sentences": [
            {
              "name": "1111111111111111"
            },
            {
              "id": "10040",
              "name": "Antonym corpus 461111111111111"
            }
          ]
        },
        {
          "tag_type": "keyword",
          "pos_sentences": [
            {
              "name": "222222222222222222222222"
            },
            {
              "id": "10094",
              "name": "Keyword 9891111111111111111"
            },
            {
              "id": "10093",
              "name": "Keyword 11111111111111111111"
            }
          ]
        }
      ],
      "sentence_id": "10863",
      "deleteTagDataList": []
    }

    Response parameters:

    {
      "resultCode": "0403000",
      "id": "10863",
      "resultDesc": "Operation successful."
    }