ujcms
  1. 访问统计接口
ujcms
  • 数据
    • 栏目列表_ChannelList
      GET
    • 栏目对象_Channel
      GET
    • 栏目对象ByAlias_Channel
      GET
    • 文章列表_ArticleList
      GET
    • 文章分页_ArticlePage
      GET
    • 文章对象_Article
      GET
    • 上一篇文章_ArticlePrev
      GET
    • 下一篇文章_ArticleNext
      GET
    • 全文检索文章分页_EsArticlePage
      GET
    • 全文检索文章列表_EsArticleList
      GET
    • 区块项列表_BlockItemList
      GET
    • 字典列表_DictList
      GET
    • 模型列表_ModelList
      GET
    • 模型对象_Model
      GET
    • Tag列表_TagList
      GET
    • Tag分页_TagPage
      GET
    • 获取Tag对象
      GET
    • 表单列表_FormList
      GET
    • 表单分页_FormPage
      GET
    • 获取表单对象
      GET
    • 站点列表_SiteList
      GET
    • 站点对象_Site
      GET
    • 投票列表_VoteList
      GET
    • 投票分页_VotePage
      GET
    • 投票对象_Vote
      GET
    • 留言列表_MessageBoardList
      GET
    • 留言分页_MessageBoardPage
      GET
    • 获取留言对象
      GET
    • 留言类型列表_MessageBoardTypeList
      GET
    • 调查问卷列表_SurveyList
      GET
    • 调查问卷分页_SurveyPage
      GET
    • 调查问卷对象_Survey
      GET
    • 文章排行榜列表_LeaderBoardList
      GET
    • 文章排行榜分页_LeaderBoardPage
      GET
  • 内容
    • 栏目接口
      • 获取栏目浏览次数
      • 获取栏目统计数据
    • 文章接口
      • 顶文章
      • 记录下载次数
      • 踩文章
      • 获取文章浏览次数
      • 获取下载参数
      • 获取文章统计数据
    • 站点接口
      • 获取站点缓冲对象,并记录浏览量
      • 获取当前站点对象。如果传递subDir参数,则通过子目录查询当前站点;否则通过当前域名获取对应站点对象,无法获取则返回默认站点
      • 获取站点缓冲对象
    • 投票接口
      • 投票
    • 留言接口
      • 提交留言
    • 调查问卷接口
      • 投票
  • 用户
    • JWT认证接口
      • 刷新TOKEN
      • 退出。一般情况下JWT无需服务器端退出。该方法主要用于记录退出日志
      • 登录
    • 注册接口
      • 用户注册
    • 密码接口
      • 更新密码
      • 重置密码
    • 会员设置接口
      • 更新个人信息
      • 更新手机号码
      • 更新邮箱地址
      • 更新个人头像
    • 用户接口
      • 用户名是否未使用
      • 用户名是否存在
      • 手机号码是否未使用
      • 手机号码是否存在
      • 邮箱地址是否未使用
      • 邮箱地址是否存在
    • 上传接口
      • avatarUpload
      • avatarCrop
  • 系统
    • 环境接口
      • 是否开启双因子登录
      • 获得当前登录用户
      • 获取当前站点列表
      • csrf 参数
      • 获取Config配置
      • 获取客户端SM2加密 public key
    • 验证码接口
      • 尝试验证码是否正确
      • 是否显示验证码。当登录错误超过指定次数后,需要输入验证码
      • 获取验证码Token
    • 短信接口
      • 发送手机短信
      • 发送邮件短信
      • 验证手机短信是否正确
      • 验证邮件短信是否正确
  • 其它
    • 访问统计接口
      • 记录访问统计接口
        POST
      • 获取在线访问者数量
        GET
  1. 访问统计接口

记录访问统计接口

POST
/api/visit/{siteId}
访问统计接口

请求参数

Path 参数
siteId
integer <int64>
站点ID
必需
Body 参数application/json
访问统计参数
url
string 
必需
受访URL地址。即需要记录的访问地址。js中可以使用document.location.href获取
entryUrl
string 
可选
入口地址。用户每次浏览网站,通常会浏览多个页面,第一个打开的页面即为入口页面
referrer
string 
可选
来源页面。当前页面的上一个页面。js中可以使用document.referrer获取
si
integer <int64>
必需
会话ID(Session ID)。可以在页面中使用随机数生成会话ID,同一个会话访问需确保会话ID相同
uv
integer <int64>
必需
访客ID(Unique Visitor)。可以在页面中使用随机数生成访客ID,同一个访客访问需确保访客ID相同
newVisitor
boolean 
必需
是否新访客。如果用户是第一次访问网站,本次会话的所有访问都应为新访客访问
count
integer <int32>
必需
访问计数。正常访问为1,关闭页面结束访问为0
duration
integer <int32>
必需
持续时间。本次访问会话的持续时间,从本次会话访问的第一个页面开始计算时间。单位:秒
示例
{
    "url": "string",
    "entryUrl": "string",
    "referrer": "string",
    "si": 0,
    "uv": 0,
    "newVisitor": true,
    "count": 0,
    "duration": 0
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://demo.ujcms.com/api/visit/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "string",
    "entryUrl": "string",
    "referrer": "string",
    "si": 0,
    "uv": 0,
    "newVisitor": true,
    "count": 0,
    "duration": 0
}'

返回响应

🟢200成功
OK
该响应没有 Body
上一页
验证邮件短信是否正确
下一页
获取在线访问者数量
Built with