updated samples

Author: detain

OPENAPI-REST-API/openapi-client/ada/.openapi-generator/VERSION

@@ -1 +1 @@
-7.20.0
+7.21.0

OPENAPI-REST-API/openapi-client/ada/src/client/-clients.adb

@@ -4,7 +4,7 @@
 --  The version of the OpenAPI document: 0.9.0
 --  Contact: support@interserver.net
 --
---  NOTE: This package is auto generated by OpenAPI-Generator 7.20.0.
+--  NOTE: This package is auto generated by OpenAPI-Generator 7.21.0.
 --  https://openapi-generator.tech
 --  Do not edit the class manually.
 
@@ -2516,6 +2516,22 @@ package body .Clients is
 
    --  View Mail Log
    --  Returns a paginated log of emails sent through this mail service, with optional filtering by sender, recipient, date range, and delivery status.
+   --  
+   --  **Row grouping** is controlled by the `groupby` parameter.  By default (`groupby=recipient`), the response contains one row per delivery attempt — so a single message sent to 4 recipients produces 4 rows, each with its own `recipient`, `delivered`, `response`, and `mxHostname` values.  Set `groupby=message` to collapse to one row per message (delivery fields will reflect one arbitrary recipient).
+   --  
+   --  **Pagination** is controlled by `skip` and `limit`.  The `total` in the response reflects the row count **after** grouping, so it matches the number of pages you need to fetch.
+   --  
+   --  **Date filtering** accepts either a Unix timestamp (integer) or a date string parseable by PHP `strtotime()` such as `2024-01-15`, `last monday`, or `2024-01-01 00:00:00`.  Examples: `startDate=1704067200&endDate=1706745599` or `startDate=2024-01-01&endDate=2024-01-31`.
+   --  
+   --  **Sorting** is controlled by `sort` and `dir`.  Currently the only sort key is `time` (default), which orders by internal row ID.
+   --  
+   --  **Delivery status** can be filtered with the `delivered` parameter: `delivered=1` returns only successfully delivered messages; `delivered=0` returns messages still in queue or that failed.
+   --  
+   --  **Address filtering** distinguishes between the SMTP envelope address (`from`, `to`) and message headers (`headerfrom` for the `From:` header, `replyto` for `Reply-To:`). These may differ when a message is sent on behalf of another address.
+   --  
+   --  The `mailid` parameter corresponds to the `id` field in the returned `MailLogEntry` objects, **not** the `_id` field.  It also matches the transaction ID returned in the `text` field of a successful send response.
+   --  
+   --  The `messageId` parameter searches the `Message-ID` email header (case-insensitive substring match).
    procedure View_Mail_Log
       (Client : in out Client_Type;
        Id : in Integer;
@@ -2526,11 +2542,17 @@ package body .Clients is
        To : in Swagger.Nullable_UString;
        Subject : in Swagger.Nullable_UString;
        Mailid : in Swagger.Nullable_UString;
+       Message_Id : in Swagger.Nullable_UString;
+       Replyto : in Swagger.Nullable_UString;
+       Headerfrom : in Swagger.Nullable_UString;
+       Delivered : in Swagger.Nullable_Integer;
        Skip : in Swagger.Nullable_Integer;
        Limit : in Swagger.Nullable_Integer;
-       Start_Date : in Swagger.Nullable_Long;
-       End_Date : in Swagger.Nullable_Long;
-       Delivered : in Swagger.Nullable_UString;
+       Start_Date : in .Models.ViewMailLogStartDateParameter_Type;
+       End_Date : in .Models.ViewMailLogStartDateParameter_Type;
+       Sort : in Swagger.Nullable_UString;
+       Dir : in Swagger.Nullable_UString;
+       Groupby : in Swagger.Nullable_UString;
        Result : out .Models.MailLog_Type) is
       URI   : Swagger.Clients.URI_Type;
       Reply : Swagger.Value_Type;
@@ -2545,11 +2567,17 @@ package body .Clients is
       URI.Add_Param ("to", To);
       URI.Add_Param ("subject", Subject);
       URI.Add_Param ("mailid", Mailid);
+      URI.Add_Param ("messageId", Message_Id);
+      URI.Add_Param ("replyto", Replyto);
+      URI.Add_Param ("headerfrom", Headerfrom);
+      URI.Add_Param ("delivered", Delivered);
       URI.Add_Param ("skip", Skip);
       URI.Add_Param ("limit", Limit);
-      URI.Add_Param ("startDate", Start_Date);
-      URI.Add_Param ("endDate", End_Date);
-      URI.Add_Param ("delivered", Delivered);
+      URI.Add_Param ("startDate", .Models.To_String (Start_Date));
+      URI.Add_Param ("endDate", .Models.To_String (End_Date));
+      URI.Add_Param ("sort", Sort);
+      URI.Add_Param ("dir", Dir);
+      URI.Add_Param ("groupby", Groupby);
       URI.Set_Path ("/mail/{id}/log");
       URI.Set_Path_Param ("id", .Models.To_String (Id));
       Client.Call (Swagger.Clients.GET, URI, Reply);

OPENAPI-REST-API/openapi-client/ada/src/client/-clients.ads

@@ -4,7 +4,7 @@
 --  The version of the OpenAPI document: 0.9.0
 --  Contact: support@interserver.net
 --
---  NOTE: This package is auto generated by OpenAPI-Generator 7.20.0.
+--  NOTE: This package is auto generated by OpenAPI-Generator 7.21.0.
 --  https://openapi-generator.tech
 --  Do not edit the class manually.
 
@@ -977,6 +977,22 @@ package .Clients is
 
    --  View Mail Log
    --  Returns a paginated log of emails sent through this mail service, with optional filtering by sender, recipient, date range, and delivery status.
+   --  
+   --  **Row grouping** is controlled by the `groupby` parameter.  By default (`groupby=recipient`), the response contains one row per delivery attempt — so a single message sent to 4 recipients produces 4 rows, each with its own `recipient`, `delivered`, `response`, and `mxHostname` values.  Set `groupby=message` to collapse to one row per message (delivery fields will reflect one arbitrary recipient).
+   --  
+   --  **Pagination** is controlled by `skip` and `limit`.  The `total` in the response reflects the row count **after** grouping, so it matches the number of pages you need to fetch.
+   --  
+   --  **Date filtering** accepts either a Unix timestamp (integer) or a date string parseable by PHP `strtotime()` such as `2024-01-15`, `last monday`, or `2024-01-01 00:00:00`.  Examples: `startDate=1704067200&endDate=1706745599` or `startDate=2024-01-01&endDate=2024-01-31`.
+   --  
+   --  **Sorting** is controlled by `sort` and `dir`.  Currently the only sort key is `time` (default), which orders by internal row ID.
+   --  
+   --  **Delivery status** can be filtered with the `delivered` parameter: `delivered=1` returns only successfully delivered messages; `delivered=0` returns messages still in queue or that failed.
+   --  
+   --  **Address filtering** distinguishes between the SMTP envelope address (`from`, `to`) and message headers (`headerfrom` for the `From:` header, `replyto` for `Reply-To:`). These may differ when a message is sent on behalf of another address.
+   --  
+   --  The `mailid` parameter corresponds to the `id` field in the returned `MailLogEntry` objects, **not** the `_id` field.  It also matches the transaction ID returned in the `text` field of a successful send response.
+   --  
+   --  The `messageId` parameter searches the `Message-ID` email header (case-insensitive substring match).
    procedure View_Mail_Log
       (Client : in out Client_Type;
        Id : in Integer;
@@ -987,11 +1003,17 @@ package .Clients is
        To : in Swagger.Nullable_UString;
        Subject : in Swagger.Nullable_UString;
        Mailid : in Swagger.Nullable_UString;
+       Message_Id : in Swagger.Nullable_UString;
+       Replyto : in Swagger.Nullable_UString;
+       Headerfrom : in Swagger.Nullable_UString;
+       Delivered : in Swagger.Nullable_Integer;
        Skip : in Swagger.Nullable_Integer;
        Limit : in Swagger.Nullable_Integer;
-       Start_Date : in Swagger.Nullable_Long;
-       End_Date : in Swagger.Nullable_Long;
-       Delivered : in Swagger.Nullable_UString;
+       Start_Date : in .Models.ViewMailLogStartDateParameter_Type;
+       End_Date : in .Models.ViewMailLogStartDateParameter_Type;
+       Sort : in Swagger.Nullable_UString;
+       Dir : in Swagger.Nullable_UString;
+       Groupby : in Swagger.Nullable_UString;
        Result : out .Models.MailLog_Type);
 
    --  Get Captcha Challenge