* refactor: rename queryannouncementhandler.go to queryAnnouncementLogic.go for clarity
* feat(panDomain): update subscription logic to use V2 handler for improved functionality
* refactor(subscribe): replace V2 handler with a unified Handler method for subscription logic
* feat(subscribe): implement user agent limit feature with configurable list
* fix(subscribe): improve error handling and logging for subscription requests
* feat(subscribe): add user agent limit configuration to system settings
* refactor(api): remove deprecated application-related endpoints and types
* refactor(swagger): remove deprecated app.json generation from swagger configuration
* refactor(swagger): remove deprecated app.json check from swagger configuration
* fix(subscribe): update delete method to use Where clause for improved query accuracy
* fix(subscribe): update Id field tag to use primaryKey and improve save method query
* fix(subscribe): update Id field tag to use primaryKey and improve model queries
* fix(subscribe): rename variable for clarity and add special handling for Stash user agent
* fix(email): convert RegisterStartTime and RegisterEndTime to time.Time for accurate query filtering
* refactor(log): consolidate logging models and update related logic for improved clarity and functionality
* fix(types): change Content field type in MessageLog to interface{} for improved flexibility
* fix(log): change MessageLog list to use value type for improved performance and memory efficiency
* fix(email): set EmailTypeVerify in task payload and update content type conversion for verification email
* fix(log): remove unused Id field from SystemLog during login log insertion
* fix(login): remove debug logs and error logging during user login process
* fix(log): add traffic reset logging for subscription resets
* fix(log): insert reset traffic log during subscription activation
* feat(log): add endpoints for retrieving and resetting subscribe traffic logs
* refactor(log): remove Reset Subscribe Traffic Log endpoint and related types
* feat(traffic): add traffic statistics logging and scheduling
* fix(subscribe): ensure active status and reset timestamps during traffic resets
* feat(api): enhance server and node management with new request/response structures
* refactor(api): rename OnlineUser to ServerOnlineUser for clarity
* feat(api): define OnlineUser type with SID and IP fields
* feat(server): implement server management handlers and database schema
* feat(api): add traffic log details filtering and enhance traffic log structures
* feat(api): migrate server and node data handling, update related structures and logic
* feat(server): implement server deletion logic with error handling
* feat(api): update log filtering to use ResetSubscribe type for subscription logs
* feat(api): standardize timestamp field across log structures
* feat(api): refactor cache key handling for server and user lists
* feat(api): enhance server status handling with protocol support and refactor related logic
* fix(traffic): adjust start date for traffic statistics and improve log deletion comment
* feat(api): implement daily traffic ranking for users and servers with error handling
* feat(api): update server total data response to use 'OnlineUsers' and implement daily traffic statistics logging
* feat(api): add log settings management with auto-clear and clear days configuration
* fix(log): correct category in log settings update query
* feat(routes): add handler for scheduled traffic statistics
* feat(model): add user counts struct and update queries for new and renewal users
* feat(api): add referral percentage and only first purchase fields to user model and requests
* feat(database): update user table to add referral percentage and only first purchase fields
* feat(api): add reset sort endpoints for server and node
* feat(api): add sort field to server model
* feat(api): implement sorting functionality for nodes and servers
* fix(database): add sort column to nodes table
* fix(model): enhance user statistics queries with new order and renewal order counts
* fix(log): update timestamp handling in login and registration logs
* fix(log): update sorting logic for server and user subscribe traffic logs
* fix(server): add server status handling based on last reported time
* fix(model): correct filter condition to use 'date' instead of 'data'
* fix(migration): add index for traffic log on timestamp, user_id, and subscribe_id
* fix(log): optimize user traffic rank data handling by using append instead of index assignment
* fix(filter): refactor node list creation to use append and remove duplicates from tags
* fix(node): add ServerId and Enabled fields to node update logic
* feat(tags): add endpoint to query all node tags
* fix(preview): add Preload parameter to FilterNodeList for improved data retrieval
* fix(log): date is empty
* feat(subscribe): add Language field to subscription models and update query logic
* feat(subscription): add Language parameter to GetSubscription request and update query logic
* fix(server): encode ServerKey in base64 and update last reported time for nodes
* feat: delete common GetSubscription
* feat(subscription): implement FilterList method for subscription queries and update related logic
* fix(subscribe): remove duplicate user agents in SubscribeHandler
* fix(push): initialize onlineUsers as a map in pushOnlineUsersLogic
* fix(reset): initialize subs as a map in clearCache method
* refactor(query): simplify node and tag filtering using InSet function
* feat(userlist): enhance GetServerUserListLogic with improved node and tag handling
* fix(userlist): correct node ID assignment and update query logic for tag filtering
* fix(userlist): correct node ID assignment in getServerUserListLogic
* refactor(query): streamline query construction for tag filtering
* fix(statistics): optimize server ranking data handling in QueryServerTotalDataLogic
* refactor(statistics): simplify server ranking data construction in QueryServerTotalDataLogic
* fix(statistics): correct server traffic data assignment in QueryServerTotalDataLogic
* fix(statistics): optimize yesterday's top 10 server traffic data assignment in QueryServerTotalDataLogic
* fix(middleware): remove duplicate elements from user agent list in PanDomainMiddleware
* feat(middleware): enhance user agent handling by querying client list in PanDomainMiddleware
* feat(client): subscribe_template
* feat(oauth): add user agent and IP logging to registration and login processes
* fix(balance): add timestamp to balance logs for payment, refund, and recharge transactions
* fix(log): correct comment for CommissionTypeRefund to improve clarity
* fix(log): replace magic number with constant for gift type in purchase checkout logic
* fix(log): rename OrderId to OrderNo for consistency in balance logging
* feat(log): add logging for balance, gift amount, and commission adjustments
* fix(user): correct placement of DeepCopy for user info update logic
* feat(log): add UserSubscribeId to FilterSubscribeLogRequest for enhanced filtering
* fix(purchase): streamline error handling and improve JSON marshaling for temporary orders
* fix(order): simplify commission handling and improve payload parsing logic
* fix(order): update commission calculation to actual payment amount minus gateway handling fee
* feat(payment): add support for CryptoSaaS payment platform and enhance configuration handling
* fix(balance): update QueryUserBalanceLog response structure to include balance log list
* fix(email): update task progress handling to use specific task ID for updates
* feat(quota): add quota task creation and querying endpoints with updated data structures
* fix(email): update task handling to use generic task model and improve error logging
* fix(order): improve error logging for database transaction and user cache updates
* feat(quota): enhance quota task management with new request structures and processing logic
* fix(quota): remove redundant quota task status endpoint from admin marketing routes
* fix(worker): update task completion status handling in worker logic
* fix(quota): update taskInfo to include current subscription count in quota logic
* doc(log): rename function for clarity and add cache cleanup comment
* fix(quota): update time handling in quota logic and correct subscriber ID query
* fix(quota): update time handling to use UnixMilli for start time in quota logic
* feat(protocol): add server protocol configuration query and enhance protocol options
* fix(quota): correct time range queries for start and expire times in quota logic
* fix(types): update plugin options to include 'none' in the plugin field
---------
Co-authored-by: Chang lue Tsen <tension@ppanel.dev>
162 lines
5.2 KiB
Plaintext
162 lines
5.2 KiB
Plaintext
syntax = "v1"
|
|
|
|
info (
|
|
title: "Subscribe API"
|
|
desc: "API for ppanel"
|
|
author: "Tension"
|
|
email: "tension@ppanel.com"
|
|
version: "0.0.1"
|
|
)
|
|
|
|
import "../types.api"
|
|
|
|
type (
|
|
GetSubscribeDetailsRequest {
|
|
Id int64 `form:"id" validate:"required"`
|
|
}
|
|
CreateSubscribeGroupRequest {
|
|
Name string `json:"name" validate:"required"`
|
|
Description string `json:"description"`
|
|
}
|
|
UpdateSubscribeGroupRequest {
|
|
Id int64 `json:"id" validate:"required"`
|
|
Name string `json:"name" validate:"required"`
|
|
Description string `json:"description"`
|
|
}
|
|
GetSubscribeGroupListResponse {
|
|
List []SubscribeGroup `json:"list"`
|
|
Total int64 `json:"total"`
|
|
}
|
|
DeleteSubscribeGroupRequest {
|
|
Id int64 `json:"id" validate:"required"`
|
|
}
|
|
BatchDeleteSubscribeGroupRequest {
|
|
Ids []int64 `json:"ids" validate:"required"`
|
|
}
|
|
CreateSubscribeRequest {
|
|
Name string `json:"name" validate:"required"`
|
|
Language string `json:"language"`
|
|
Description string `json:"description"`
|
|
UnitPrice int64 `json:"unit_price"`
|
|
UnitTime string `json:"unit_time"`
|
|
Discount []SubscribeDiscount `json:"discount"`
|
|
Replacement int64 `json:"replacement"`
|
|
Inventory int64 `json:"inventory"`
|
|
Traffic int64 `json:"traffic"`
|
|
SpeedLimit int64 `json:"speed_limit"`
|
|
DeviceLimit int64 `json:"device_limit"`
|
|
Quota int64 `json:"quota"`
|
|
Nodes []int64 `json:"nodes"`
|
|
NodeTags []string `json:"node_tags"`
|
|
Show *bool `json:"show"`
|
|
Sell *bool `json:"sell"`
|
|
DeductionRatio int64 `json:"deduction_ratio"`
|
|
AllowDeduction *bool `json:"allow_deduction"`
|
|
ResetCycle int64 `json:"reset_cycle"`
|
|
RenewalReset *bool `json:"renewal_reset"`
|
|
}
|
|
UpdateSubscribeRequest {
|
|
Id int64 `json:"id" validate:"required"`
|
|
Name string `json:"name" validate:"required"`
|
|
Language string `json:"language"`
|
|
Description string `json:"description"`
|
|
UnitPrice int64 `json:"unit_price"`
|
|
UnitTime string `json:"unit_time"`
|
|
Discount []SubscribeDiscount `json:"discount"`
|
|
Replacement int64 `json:"replacement"`
|
|
Inventory int64 `json:"inventory"`
|
|
Traffic int64 `json:"traffic"`
|
|
SpeedLimit int64 `json:"speed_limit"`
|
|
DeviceLimit int64 `json:"device_limit"`
|
|
Quota int64 `json:"quota"`
|
|
Nodes []int64 `json:"nodes"`
|
|
NodeTags []string `json:"node_tags"`
|
|
Show *bool `json:"show"`
|
|
Sell *bool `json:"sell"`
|
|
Sort int64 `json:"sort"`
|
|
DeductionRatio int64 `json:"deduction_ratio"`
|
|
AllowDeduction *bool `json:"allow_deduction"`
|
|
ResetCycle int64 `json:"reset_cycle"`
|
|
RenewalReset *bool `json:"renewal_reset"`
|
|
}
|
|
SubscribeSortRequest {
|
|
Sort []SortItem `json:"sort"`
|
|
}
|
|
GetSubscribeListRequest {
|
|
Page int64 `form:"page" validate:"required"`
|
|
Size int64 `form:"size" validate:"required"`
|
|
Language string `form:"language,omitempty"`
|
|
Search string `form:"search,omitempty"`
|
|
}
|
|
SubscribeItem {
|
|
Subscribe
|
|
Sold int64 `json:"sold"`
|
|
}
|
|
GetSubscribeListResponse {
|
|
List []SubscribeItem `json:"list"`
|
|
Total int64 `json:"total"`
|
|
}
|
|
DeleteSubscribeRequest {
|
|
Id int64 `json:"id" validate:"required"`
|
|
}
|
|
BatchDeleteSubscribeRequest {
|
|
Ids []int64 `json:"ids" validate:"required"`
|
|
}
|
|
)
|
|
|
|
@server (
|
|
prefix: v1/admin/subscribe
|
|
group: admin/subscribe
|
|
middleware: AuthMiddleware
|
|
)
|
|
service ppanel {
|
|
@doc "Create subscribe group"
|
|
@handler CreateSubscribeGroup
|
|
post /group (CreateSubscribeGroupRequest)
|
|
|
|
@doc "Update subscribe group"
|
|
@handler UpdateSubscribeGroup
|
|
put /group (UpdateSubscribeGroupRequest)
|
|
|
|
@doc "Get subscribe group list"
|
|
@handler GetSubscribeGroupList
|
|
get /group/list returns (GetSubscribeGroupListResponse)
|
|
|
|
@doc "Delete subscribe group"
|
|
@handler DeleteSubscribeGroup
|
|
delete /group (DeleteSubscribeGroupRequest)
|
|
|
|
@doc "Batch delete subscribe group"
|
|
@handler BatchDeleteSubscribeGroup
|
|
delete /group/batch (BatchDeleteSubscribeGroupRequest)
|
|
|
|
@doc "Create subscribe"
|
|
@handler CreateSubscribe
|
|
post / (CreateSubscribeRequest)
|
|
|
|
@doc "Update subscribe"
|
|
@handler UpdateSubscribe
|
|
put / (UpdateSubscribeRequest)
|
|
|
|
@doc "Get subscribe list"
|
|
@handler GetSubscribeList
|
|
get /list (GetSubscribeListRequest) returns (GetSubscribeListResponse)
|
|
|
|
@doc "Delete subscribe"
|
|
@handler DeleteSubscribe
|
|
delete / (DeleteSubscribeRequest)
|
|
|
|
@doc "Batch delete subscribe"
|
|
@handler BatchDeleteSubscribe
|
|
delete /batch (BatchDeleteSubscribeRequest)
|
|
|
|
@doc "Get subscribe details"
|
|
@handler GetSubscribeDetails
|
|
get /details (GetSubscribeDetailsRequest) returns (Subscribe)
|
|
|
|
@doc "Subscribe sort"
|
|
@handler SubscribeSort
|
|
post /sort (SubscribeSortRequest)
|
|
}
|
|
|