Soul App API 文档

Soul App API 文档

概述

Soul App（灵魂社交）的API接口文档，用于访问用户资料、动态内容和社交功能。

文档信息：

• 发布时间：2024-11-25
• 作者：Ben

基础URL

• Web界面：https://w13.soulsmile.cn
• API接口：https://api-h5.soulapp.cn
• 应用接口：https://app.soulapp.cn

核心参数

系统使用三个主要的加密参数：

• userIdEcpt：用户ID的加密形式
• postIdEcpt：动态内容ID的加密形式
• tagIdEcpt：标签ID的加密形式

API端点列表

1. 用户相关接口

用户资料

GET https://api-h5.soulapp.cn/html/v2/user/info?userIdEcpt={userIdEcpt}

返回

{
  "code": 10001,
  "message": "获取成功！",
  "data": {
    "userId": -1,
    "signature": "小汤包",
    "avatarName": "avatar-1601051400556-00231",
    "avatarBgColor": "HeaderColor_Default",
    "userBackgroundUrl": "/image/2024-07-27/0a81d8c2-c0dc-4bcb-a1cc-1d1d7bca8e45-1722059412322.png",
    "registerTime": 1630866778000,
    "registerDays": 1177,
    "postCount": 20,
    "gender": 1,
    "headImgurl": null,
    "nickName": null,
    "openId": null,
    "followed": false,
    "alias": null,
    "userIdEcpt": "QU5FUTRpMFRxZGFIY0JMSUs3VlMxZz09"
  },
  "success": true
}

2. 动态内容接口

获取单条动态详情

GET https://api-h5.soulapp.cn/html/v3/post/detail?postIdEcpt={postIdEcpt}

返回

{
  "code": 10001,
  "message": "获取成功",
  "data": {
    "post": {
      "authorIdEcpt": "QU5FUTRpMFRxZGFIY0JMSUs3VlMxZz09",
      "userIdEcpt": null,
      "targetUserIdEcpt": null,
      "subTargetUserIdEcpt": null,
      "replyToUserIdEcpt": null,
      "replyToAuthorIdEcpt": null,
      "msgToIdEcpt": null,
      "ownerIdEcpt": null,
      "targetIdEcpt": null,
      "actorIdEcpt": null,
      "parentAuthorIdEcpt": null,
      "soulmateUserIdEcpt": null,
      "postIdEcpt": "NFAycWsxMytYN3cydTFIbjhydDcxQT09",
      "tagIdEcpt": null,
      "postId": -1,
      "type": "IMAGE",
      "authorId": -1,
      "content": "骑着我的雅迪，怎么触碰开着奥迪的你",
      "weather": "晴",
      "soulmate": false,
      "createTime": 1732473460037,
      "position": null,
      "soulmateUserId": -1,
      "attachments": [
        {
          "id": 3189265220,
          "ownerType": null,
          "ownerId": 4139356036,
          "type": "IMAGE",
          "state": null,
          "orderNo": null,
          "createTime": null,
          "modifyTime": null,
          "deleteTime": null,
          "fileUrl": "https://china-img.soulapp.cn/image/2024-11-25/e5c0b356-1e65-4ada-a377-9f755c64c1f1-1732473459444.png",
          "fileDuration": null,
          "fileFormat": null,
          "fileWidth": 1080,
          "fileHeight": 1232,
          "fileSize": null,
          "materialsInfo": null,
          "pictureInfo": null,
          "cameraInfo": null,
          "deviceInfo": null,
          "shuiyinUrl": null,
          "ext": "{\"camIcon\":\"soul\",\"resizeFileUrl\":\"https://soul-app.oss-cn-hangzhou-internal.aliyuncs.com/image/2024-11-25/e5c0b356-1e65-4ada-a377-9f755c64c1f1-1732473459444.png?x-oss-process=image/crop,w_924,g_center\"}",
          "fileSource": null,
          "domain": "https://china-img.soulapp.cn/",
          "relativePath": "image/2024-11-25/e5c0b356-1e65-4ada-a377-9f755c64c1f1-1732473459444.png",
          "audioCoverUrl": null,
          "videoCoverUrl": null,
          "audioMojiUrl": null,
          "audioName": null,
          "audioNameExist": null,
          "audioStyleId": null,
          "audioStyleName": null,
          "audioLabel": null
        }
      ],
      "voteItemListModel": null,
      "commentNum": "0",
      "followNum": "0",
      "likeNum": "1",
      "shareNum": "1",
      "comments": 0,
      "follows": 0,
      "likes": 1,
      "liked": false,
      "shares": 1,
      "comeFrom": "来自#务实家星球",
      "signature": "小汤包",
      "avatarName": "avatar-1601051400556-00231",
      "avatarColor": "HeaderColor_Default",
      "targetAvatarName": null,
      "targetAvatarColor": null,
      "songInfoResModel": null,
      "tags": [],
      "innerTags": null,
      "coauthor": null,
      "isVotePost": null,
      "score": null,
      "officialTag": null,
      "authorfollowed": false,
      "campusModel": null,
      "postRoomProfileModel": null,
      "postGroupBriefModel": null,
      "exposeId": 4139356036,
      "globalViewModel": null,
      "aiTag": null,
      "votePost": null
    },
    "commentInfos": []
  },
  "success": true
}

获取用户动态列表

GET https://api-h5.soulapp.cn/html/v2/post/homepage?userIdEcpt={userIdEcpt}

{
  "code": 10001,
  "message": "获取成功",
  "data": [
    {
      "authorIdEcpt": "VG9Kbm5NM3dZTjVYRnBhV05La1orUT09",
      "userIdEcpt": null,
      "targetUserIdEcpt": null,
      "subTargetUserIdEcpt": null,
      "replyToUserIdEcpt": null,
      "replyToAuthorIdEcpt": null,
      "msgToIdEcpt": null,
      "ownerIdEcpt": null,
      "targetIdEcpt": null,
      "actorIdEcpt": null,
      "parentAuthorIdEcpt": null,
      "soulmateUserIdEcpt": null,
      "postIdEcpt": "K2psejU2eXhxNHJBTzh1OGVxQ1g4QT09",
      "tagIdEcpt": null,
      "postId": -1,
      "type": "TEXT",
      "authorId": -1,
      "content": "南昌，一个人太累了，太孤单",
      "weather": "晴",
      "soulmate": false,
      "createTime": 1732230890384,
      "position": "南昌市",
      "soulmateUserId": -1,
      "attachments": null,
      "voteItemListModel": null,
      "commentNum": "105",
      "followNum": "1",
      "likeNum": "175",
      "shareNum": "0",
      "comments": 105,
      "follows": 1,
      "likes": 175,
      "liked": false,
      "shares": 0,
      "comeFrom": "来自#艺术家星球",
      "signature": "落日余晖下的熙攘",
      "avatarName": "avatar_girl_default",
      "avatarColor": "HeaderColor_Default",
      "targetAvatarName": null,
      "targetAvatarColor": null,
      "songInfoResModel": null,
      "tags": [],
      "innerTags": null,
      "coauthor": null,
      "isVotePost": null,
      "score": null,
      "officialTag": null,
      "authorfollowed": false,
      "campusModel": null,
      "postRoomProfileModel": null,
      "postGroupBriefModel": null,
      "exposeId": 4135766215,
      "globalViewModel": null,
      "aiTag": null,
      "votePost": null
    },
    {
      "authorIdEcpt": "VG9Kbm5NM3dZTjVYRnBhV05La1orUT09",
      "userIdEcpt": null,
      "targetUserIdEcpt": null,
      "subTargetUserIdEcpt": null,
      "replyToUserIdEcpt": null,
      "replyToAuthorIdEcpt": null,
      "msgToIdEcpt": null,
      "ownerIdEcpt": null,
      "targetIdEcpt": null,
      "actorIdEcpt": null,
      "parentAuthorIdEcpt": null,
      "soulmateUserIdEcpt": null,
      "postIdEcpt": "ODNuS21DaEpReVpjOHFnWnNrZmtVQT09",
      "tagIdEcpt": null,
      "postId": -1,
      "type": "TEXT",
      "authorId": -1,
      "content": "南昌，我心情不好有聊的会没，",
      "weather": "晴",
      "soulmate": false,
      "createTime": 1732176121376,
      "position": "南昌市",
      "soulmateUserId": -1,
      "attachments": null,
      "voteItemListModel": null,
      "commentNum": "79",
      "followNum": "1",
      "likeNum": "120",
      "shareNum": "0",
      "comments": 79,
      "follows": 1,
      "likes": 120,
      "liked": false,
      "shares": 0,
      "comeFrom": "来自#艺术家星球",
      "signature": "落日余晖下的熙攘",
      "avatarName": "avatar_girl_default",
      "avatarColor": "HeaderColor_Default",
      "targetAvatarName": null,
      "targetAvatarColor": null,
      "songInfoResModel": null,
      "tags": [],
      "innerTags": null,
      "coauthor": null,
      "isVotePost": null,
      "score": null,
      "officialTag": null,
      "authorfollowed": false,
      "campusModel": null,
      "postRoomProfileModel": null,
      "postGroupBriefModel": null,
      "exposeId": 4135006945,
      "globalViewModel": null,
      "aiTag": null,
      "votePost": null
    },
    {
      "authorIdEcpt": "VG9Kbm5NM3dZTjVYRnBhV05La1orUT09",
      "userIdEcpt": null,
      "targetUserIdEcpt": null,
      "subTargetUserIdEcpt": null,
      "replyToUserIdEcpt": null,
      "replyToAuthorIdEcpt": null,
      "msgToIdEcpt": null,
      "ownerIdEcpt": null,
      "targetIdEcpt": null,
      "actorIdEcpt": null,
      "parentAuthorIdEcpt": null,
      "soulmateUserIdEcpt": null,
      "postIdEcpt": "RGlocUprUExGQ3Axck84Z2VKMFMvUT09",
      "tagIdEcpt": null,
      "postId": -1,
      "type": "TEXT",
      "authorId": -1,
      "content": "南昌我心情不咋好唠会有没",
      "weather": "晴",
      "soulmate": false,
      "createTime": 1732087851064,
      "position": "南昌市",
      "soulmateUserId": -1,
      "attachments": null,
      "voteItemListModel": null,
      "commentNum": "23",
      "followNum": "0",
      "likeNum": "40",
      "shareNum": "1",
      "comments": 23,
      "follows": 0,
      "likes": 40,
      "liked": false,
      "shares": 1,
      "comeFrom": "来自#艺术家星球",
      "signature": "落日余晖下的熙攘",
      "avatarName": "avatar_girl_default",
      "avatarColor": "HeaderColor_Default",
      "targetAvatarName": null,
      "targetAvatarColor": null,
      "songInfoResModel": null,
      "tags": [],
      "innerTags": null,
      "coauthor": null,
      "isVotePost": null,
      "score": null,
      "officialTag": null,
      "authorfollowed": false,
      "campusModel": null,
      "postRoomProfileModel": null,
      "postGroupBriefModel": null,
      "exposeId": 4133805061,
      "globalViewModel": null,
      "aiTag": null,
      "votePost": null
    }
  ],
  "success": true
}

获取标签相关动态

GET https://api-h5.soulapp.cn/html/v2/tag/post?tagIdEcpt={tagIdEcpt}

响应数据结构

动态内容字段说明

基础信息

• authorIdEcpt: 作者加密ID
• postIdEcpt: 动态加密ID
• type: 内容类型(TEXT/VIDEO等)

附件信息 (attachments)

• type: 附件类型(VIDEO等)
• id: 附件ID
• fileUrl: 文件路径
• fileWidth: 宽度
• fileHeight: 高度

统计信息

• commentNum: 评论数量
• likeNum: 点赞数量
• shareNum: 分享数量
• comeFrom: 来源信息
• signature: 作者签名

评论信息 (commentInfos)

• id: 评论ID
• authorNickName: 评论者昵称
• content: 评论内容
• userId: 评论者加密ID
  `