Create a consultation session
POST
/session-records/sessionsRequest URL
text
POST https://open-api.habitaxx.com/v1/ms-ai-fast/session-records/sessionsRequest headers
http
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/jsonRequest body
json
{
"module_type": 1,
"pet_profile_id": 44,
"content": "My cat vomited three times today and seems less active.",
"lang": "en-US",
"trace_id": "consult-20260914-0001"
}Request fields
| Field | Type | Required | Description |
|---|---|---|---|
module_type | integer | Yes | Always 1 for Smart Consultation. |
pet_profile_id | integer | Yes | Positive numeric pet-profile ID. |
content | string | Yes | Initial complaint or first user message; must not be empty. |
lang | string | No | Session language; defaults to zh-CN. |
trace_id | string | No | Client trace identifier, maximum 100 characters. |
Response example
json
{
"code": 200,
"message": "success",
"data": {
"session_id": "doc_1234567890abcdef",
"medical_record_id": 10001,
"medical_record": {
"id": 10001,
"pet_profile_id": 44,
"module_type": 1,
"status": 1,
"lang": "en-US",
"created_at": "2026-09-14T10:00:00"
},
"initial_message": {
"id": 1,
"role": "user",
"content": "My cat vomited three times today and seems less active.",
"content_type": 1,
"created_at": "2026-09-14T10:00:00"
}
}
}Response fields
| Field | Type | Description |
|---|---|---|
session_id | string | Session ID for all later consultation requests. |
medical_record_id | integer/null | Related AI record ID. |
medical_record | object | The AI record created for this session. The current service returns this object on successful creation. |
medical_record.id | integer | AI record ID; identical to medical_record_id. |
medical_record.created_at | string | Record creation time (ISO 8601, UTC+8). |
medical_record.pet_profile_id | integer | Associated pet-profile ID. |
medical_record.module_type | integer | Module: 1 Smart Consultation, 5 Pet Image Recognition. |
medical_record.status | integer | Business status (measured: 1 right after session creation, 2 once the report is done); use report_status to decide whether the report is complete. |
medical_record.lang | string | Session language (e.g. en-US). |
initial_message | object/null | Saved first message; it is not a request field. |
initial_message.id | integer | First-message auto-increment ID. |
initial_message.created_at | string | Message creation time (ISO 8601, UTC+8). |
initial_message.role | string | Speaker role: always "user". |
initial_message.content | string | Original value sent in the request body's content. |
initial_message.content_type | integer | Message type: 1 text, 2 image, 3 JSON. Always 1 here. |
Common errors
HTTP / code | message | Trigger |
|---|---|---|
400 | 缺少主诉 | content was not sent for module_type=1. |
400 | 缺少宠物档案ID | pet_profile_id was not sent. |
400 | 语言尚未启用: <lang> | lang is not enabled in this environment; call GET /locales first. |