1.2.1-Create a New Dialog Session

1. Overview

• Interface Name: Create a Session

• Version number: v1.3.20

2. Information

• Request method: POST

• Request URL: https://DOMAIN/openapi/v1/conversation/segment/create/

• Domain: Refer to "Service address description"

3. Request parameters

Request header http header field:

Parameter name	Type	Required	Description
Content-Type	string	Yes	Fixedapplication/json
cybertron-robot-key	string	Yes	Robot key
cybertron-robot-token	string	Yes	Robot token

Request body field:

Parameter name	Type	Required	Description
username	string	Yes	User account

4. Response field description

HTTP status code: 200 OK

Response field description:

Field Name	Type	Description
code	string	"000000" is normal, other exceptions
message	string	Status description
data	object	message body
segment_code	string	session encoding
user_code	string	user encoding
create_time	string	creation time

5. Example

Request Example:

curl 'https://_DOMAIN_/openapi/v1/conversation/segment/create/' \
-H 'Content-Type: application/json' \
-H 'cybertron-robot-key: l8ia2IOc************Z724%2BU%3D' \
-H 'cybertron-robot-token: MTc0Mzk5************************************************cGRCUTg9' \
-X POST -d '{
    "username": "[e-mail]"
}'

Response example:

{
    "code": "000000",
    "message": "Get successful",
    "data": {
        "segment_code": "wWkE3bNkL3SzJX9orcO9P",
        "user_code": "zhengdong.zhou",
        "create_time": "2024-05-28 11:44:18"
    }
}