Help Center/ Cognitive Engagement Center/ API Reference/ Survey Interface Reference/ Creating Answers to Questions (createQuestionAnswer)
Updated on 2023-09-27 GMT+08:00

Creating Answers to Questions (createQuestionAnswer)

Scenario

This interface is invoked to create an answer data record.

Method

POST

URI

https://Domain name/apiaccess/v1/scriptAnswer/createQuestionAnswer, for example, service.besclouds.com.

Request Description

Table 1 Request header parameters

No.

Parameter

Type

Mandatory or Not

Description

2

Authorization

String

Yes

Authentication field. The format is Bearer +AccessToken returned by the tokenByAKSK interface. (A space is required next to Bearer.)

3

x-app-key

String

Yes

App key field, which is the user ID. Contact the operation personnel to obtain the app key.

Table 2 Request body parameters

No.

Parameter

Type

Mandatory or Not

Description

1

questionId

String

Yes

Question ID.

2

surveyAnswerId

String

Yes

Answer ID.

3

surveyId

String

Yes

Survey ID.

4

answerText

String

No

Answer content.

5

voiceScore

DECIMAL (11,2)

No

Voice score.

6

operScore

DECIMAL (11,2)

No

Operation score.

7

optionId

String

No

Option ID.

Response Description

  • Status code: 200
    Table 3 Response body parameters

    No.

    Parameter

    Type

    Mandatory or Not

    Description

    1

    resultCode

    String

    Yes

    Return code.

    2

    resultDesc

    String

    Yes

    Description of the message returned by the interface.

    2

    questionAnswerId

    String

    Yes

    ID of an answer to a question.

  • 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: 403

    Authentication fails.

  • 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

Request header:

{
    "x-app-key": ********************
    "Authorization": Bearer ************************
}
Request parameters:
{
    "surveyId":"123456789",
    "questionId":"987654321",
    "answerNo": 1,
    "surveyAnswerId": "123456666"
}
Response parameters:
{
    "resultCode": "1203000",
    "questionAnswerId": "123456789",
    "resultDesc": "Opration Successful."
}