Update REST API documentation Thu Jul 24 09:40:58 UTC 2025

Author: github-actions

restapi.json

@@ -3350,42 +3350,123 @@
                 }
             }
         },
-        "/api/v2/subscribers/confirm": {
+        "/api/v2/subscribers/{subscriberId}/history": {
             "get": {
                 "tags": [
                     "subscribers"
                 ],
-                "summary": "Confirm a subscriber by uniqueId.",
-                "description": "🚧 **Status: Beta** – This method is under development. Avoid using in production.",
-                "operationId": "1e4d7709f3d02f54a4fe6a183b253140",
-                "requestBody": {
-                    "required": true,
-                    "content": {
-                        "application/json": {
-                            "schema": {
-                                "properties": {
-                                    "uniqueId": {
-                                        "type": "string",
-                                        "example": "e9d8c9b2e6"
-                                    }
-                                },
-                                "type": "object"
-                            }
+                "summary": "Get subscriber event history",
+                "description": "🚧 **Status: Beta** – This method is under development. Avoid using in production. ",
+                "operationId": "15830d2425a969a7482eefb114234d47",
+                "parameters": [
+                    {
+                        "name": "php-auth-pw",
+                        "in": "header",
+                        "description": "Session key obtained from login",
+                        "required": true,
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    {
+                        "name": "subscriberId",
+                        "in": "path",
+                        "description": "Subscriber ID",
+                        "required": true,
+                        "schema": {
+                            "type": "integer"
+                        }
+                    },
+                    {
+                        "name": "after_id",
+                        "in": "query",
+                        "description": "Page number (pagination)",
+                        "required": false,
+                        "schema": {
+                            "type": "integer",
+                            "default": 1
+                        }
+                    },
+                    {
+                        "name": "limit",
+                        "in": "query",
+                        "description": "Max items per page",
+                        "required": false,
+                        "schema": {
+                            "type": "integer",
+                            "default": 25
+                        }
+                    },
+                    {
+                        "name": "ip",
+                        "in": "query",
+                        "description": "Filter by IP address",
+                        "required": false,
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    {
+                        "name": "date_from",
+                        "in": "query",
+                        "description": "Filter by date (format: Y-m-d)",
+                        "required": false,
+                        "schema": {
+                            "type": "string",
+                            "format": "date"
+                        }
+                    },
+                    {
+                        "name": "summery",
+                        "in": "query",
+                        "description": "Filter by summary text",
+                        "required": false,
+                        "schema": {
+                            "type": "string"
                         }
                     }
-                },
+                ],
                 "responses": {
                     "200": {
-                        "description": "Subscriber confirmed",
+                        "description": "Paginated list of subscriber events",
                         "content": {
-                            "text/html": {}
+                            "application/json": {
+                                "schema": {
+                                    "properties": {
+                                        "items": {
+                                            "type": "array",
+                                            "items": {
+                                                "$ref": "#/components/schemas/SubscriberHistory"
+                                            }
+                                        },
+                                        "pagination": {
+                                            "$ref": "#/components/schemas/CursorPagination"
+                                        }
+                                    },
+                                    "type": "object"
+                                }
+                            }
                         }
                     },
-                    "400": {
-                        "description": "Missing or invalid uniqueId"
+                    "403": {
+                        "description": "Unauthorized",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/UnauthorizedResponse"
+                                }
+                            }
+                        }
                     },
                     "404": {
-                        "description": "Subscriber not found"
+                        "description": "Not Found",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/NotFoundErrorResponse"
+                                }
+                            }
+                        }
                     }
                 }
             }
@@ -4974,6 +5055,36 @@
                     }
                 },
                 "type": "object"
+            },
+            "SubscriberHistory": {
+                "properties": {
+                    "id": {
+                        "type": "integer",
+                        "example": 1
+                    },
+                    "ip": {
+                        "type": "string",
+                        "example": "127.0.0.1"
+                    },
+                    "created_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "example": "2022-12-01T10:00:00Z"
+                    },
+                    "summery": {
+                        "type": "string",
+                        "example": "Added by admin"
+                    },
+                    "detail": {
+                        "type": "string",
+                        "example": "Added with add-email on test"
+                    },
+                    "system_info": {
+                        "type": "string",
+                        "example": "HTTP_USER_AGENT = Mozilla/5.0"
+                    }
+                },
+                "type": "object"
             }
         }
     },