SecondMe API
User Info
Get user basic information, interest tags, and Key Memory
User information endpoints.
Base URL: https://api.mindverse.com/gate/lab
Get User Info
Get authorized user's basic information.
GET /api/secondme/user/infoAuthentication
Requires OAuth2 Token.
Required Permissions
userinfo
Request Example
curl -X GET "https://api.mindverse.com/gate/lab/api/secondme/user/info" \
-H "Authorization: Bearer lba_at_your_access_token"Response
Success (200)
{
"code": 0,
"data": {
"userId": "12345678",
"name": "Username",
"email": "user@example.com",
"avatar": "https://cdn.example.com/avatar.jpg",
"bio": "Personal bio",
"selfIntroduction": "Self introduction content",
"profileCompleteness": 85,
"route": "username"
}
}| Field | Type | Description |
|---|---|---|
| userId | string | User ID |
| name | string | User's name |
| string | User's email | |
| avatar | string | Avatar URL |
| bio | string | Personal bio |
| selfIntroduction | string | Self introduction |
| profileCompleteness | number | Profile completeness (0-100) |
| route | string | User's profile route |
Error Codes
| Error Code | Description |
|---|---|
| apikey.permission.denied | Missing userinfo permission |
Get User Shades
Get user's interest tags (only returns tags with public content).
GET /api/secondme/user/shadesAuthentication
Requires OAuth2 Token.
Required Permissions
userinfo
Request Example
curl -X GET "https://api.mindverse.com/gate/lab/api/secondme/user/shades" \
-H "Authorization: Bearer lba_at_your_access_token"Response
Success (200)
{
"code": 0,
"data": {
"shades": [
{
"id": 123,
"shadeName": "Tech Enthusiast",
"shadeIcon": "https://cdn.example.com/icon.png",
"confidenceLevel": "HIGH",
"shadeDescription": "Passionate about technology",
"shadeDescriptionThirdView": "They are passionate about technology",
"shadeContent": "Loves coding and gadgets",
"shadeContentThirdView": "They love coding and gadgets",
"sourceTopics": ["programming", "AI"],
"shadeNamePublic": "Tech Lover",
"shadeIconPublic": "https://cdn.example.com/public-icon.png",
"confidenceLevelPublic": "HIGH",
"shadeDescriptionPublic": "Tech enthusiast",
"shadeDescriptionThirdViewPublic": "A tech enthusiast",
"shadeContentPublic": "Enjoys technology",
"shadeContentThirdViewPublic": "They enjoy technology",
"sourceTopicsPublic": ["tech"],
"hasPublicContent": true
}
]
}
}| Field | Type | Description |
|---|---|---|
| shades | array | List of interest tags |
| shades[].id | number | Tag ID |
| shades[].shadeName | string | Tag name |
| shades[].shadeIcon | string | Tag icon URL |
| shades[].confidenceLevel | string | Confidence level: VERY_HIGH, HIGH, MEDIUM, LOW, VERY_LOW |
| shades[].shadeDescription | string | Tag description |
| shades[].shadeDescriptionThirdView | string | Third-person description |
| shades[].shadeContent | string | Tag content |
| shades[].shadeContentThirdView | string | Third-person content |
| shades[].sourceTopics | array | Source topics |
| shades[].shadeNamePublic | string | Public tag name |
| shades[].shadeIconPublic | string | Public icon URL |
| shades[].confidenceLevelPublic | string | Public confidence level |
| shades[].shadeDescriptionPublic | string | Public description |
| shades[].shadeDescriptionThirdViewPublic | string | Public third-person description |
| shades[].shadeContentPublic | string | Public content |
| shades[].shadeContentThirdViewPublic | string | Public third-person content |
| shades[].sourceTopicsPublic | array | Public source topics |
| shades[].hasPublicContent | boolean | Whether has public content |
Error Codes
| Error Code | Description |
|---|---|
| apikey.permission.denied | Missing userinfo permission |
Search Key Memory
Search Key Memory by keyword with pagination support.
GET /api/secondme/memory/key/search?keyword=&pageNo=1&pageSize=20Authentication
Requires OAuth2 Token.
Required Permissions
memory.read
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| keyword | string | No | Search keyword |
| pageNo | integer | No | Page number (default: 1) |
| pageSize | integer | No | Page size (default: 20) |
Request Example
curl -X GET "https://api.mindverse.com/gate/lab/api/secondme/memory/key/search?keyword=reading&pageNo=1&pageSize=20" \
-H "Authorization: Bearer lba_at_your_access_token"Response
Success (200)
{
"code": 0,
"data": {
"list": [
{
"id": 12345,
"factActor": "User",
"factObject": "Hobbies",
"factContent": "Enjoys reading science fiction novels on weekends",
"createTime": 1705315800000,
"updateTime": 1705315800000,
"visibility": 1
}
],
"total": 1
}
}| Field | Type | Description |
|---|---|---|
| list | array | Key Memory list |
| list[].id | number | Memory ID |
| list[].factActor | string | Fact actor |
| list[].factObject | string | Fact object/category |
| list[].factContent | string | Fact content |
| list[].createTime | number | Creation time (milliseconds timestamp) |
| list[].updateTime | number | Update time (milliseconds timestamp) |
| list[].visibility | number | Visibility |
| total | number | Total count |
Error Codes
| Error Code | Description |
|---|---|
| auth.token.invalid | Token is invalid or expired |