Get Today's vCard Visits (v1)
Method & Path
GET /api/v1/workspace/:workspaceId/analytics/vcard/today
Description
Get the count of today's visits for vCard pages.
Authentication
Required: Workspace authentication. User must be authenticated as Workspace Owner or Staff with workspace.read permission.
Headers
Authorization: Bearer <workspace_token>
Content-Type: application/json
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspaceId | string | Yes | Workspace identifier |
Response 200 OK
{
"visits": 32
}
Response Fields
visits(number): Number of visits today (since midnight UTC)
Common Errors
401 Unauthorized: Missing or invalid authentication token
403 Forbidden: User does not have workspace.read permission
404 Not Found: Workspace not found
500 Internal Server Error: Server error occurred while processing the request
Notes
- Count is based on UTC timezone (resets at midnight UTC)
- Only counts first visits (new sessions), not page views