@opusdns/api 0.207.0 → 0.209.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3688,141 +3688,6 @@ export type GET_DomainForwardsByHostnameByProtocol_Response_404 = Problem
3688
3688
  */
3689
3689
  export type GET_DomainForwardsByHostnameByProtocol_Response_422 = HTTPValidationError
3690
3690
 
3691
- /**
3692
- * Response types for POST DomainForwardsByHostnameByProtocol endpoint
3693
- *
3694
- * Create domain forward set (deprecated)
3695
- * Deprecated: Use POST /{hostname} with protocol in body instead. Creates a new domain forward set for a specific protocol (HTTP or HTTPS).
3696
- *
3697
- * @remarks
3698
- * This type defines all possible response structures for the POST DomainForwardsByHostnameByProtocol endpoint.
3699
- * Each response code maps to a specific response type as defined in the OpenAPI specification.
3700
- * Use this type to ensure type safety when handling API responses from this endpoint.
3701
- *
3702
-
3703
- *
3704
- * @path /v1/domain-forwards/{hostname}/{protocol}
3705
- * @param hostname (path) - Hostname
3706
- *
3707
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response_201} - 201 response type
3708
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response_401} - 401 response type
3709
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response_403} - 403 response type
3710
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response_404} - 404 response type
3711
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response_409} - 409 response type
3712
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response_422} - 422 response type
3713
- *
3714
-
3715
- */
3716
- export type POST_DomainForwardsByHostnameByProtocol_Response = POST_DomainForwardsByHostnameByProtocol_Response_201 | POST_DomainForwardsByHostnameByProtocol_Response_401 | POST_DomainForwardsByHostnameByProtocol_Response_403 | POST_DomainForwardsByHostnameByProtocol_Response_404 | POST_DomainForwardsByHostnameByProtocol_Response_409 | POST_DomainForwardsByHostnameByProtocol_Response_422;
3717
-
3718
- /**
3719
- * 201 response for POST DomainForwardsByHostnameByProtocol endpoint
3720
- *
3721
- * @remarks
3722
- * This type defines the response structure for the 201 status code
3723
- * of the POST DomainForwardsByHostnameByProtocol endpoint.
3724
- * It provides type safety for handling this specific response as defined in the OpenAPI specification.
3725
- *
3726
-
3727
- *
3728
- * @path /v1/domain-forwards/{hostname}/{protocol}
3729
- * @param hostname (path) - Hostname
3730
- *
3731
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response} - The main response type definition
3732
- * @see {@link DomainForwardSet} - The actual schema type definition
3733
- */
3734
- export type POST_DomainForwardsByHostnameByProtocol_Response_201 = DomainForwardSet
3735
-
3736
- /**
3737
- * 401 response for POST DomainForwardsByHostnameByProtocol endpoint
3738
- *
3739
- * @remarks
3740
- * This type defines the response structure for the 401 status code
3741
- * of the POST DomainForwardsByHostnameByProtocol endpoint.
3742
- * It provides type safety for handling this specific response as defined in the OpenAPI specification.
3743
- *
3744
-
3745
- *
3746
- * @path /v1/domain-forwards/{hostname}/{protocol}
3747
- * @param hostname (path) - Hostname
3748
- *
3749
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response} - The main response type definition
3750
- * @see {@link Problem} - The actual schema type definition
3751
- */
3752
- export type POST_DomainForwardsByHostnameByProtocol_Response_401 = Problem
3753
-
3754
- /**
3755
- * 403 response for POST DomainForwardsByHostnameByProtocol endpoint
3756
- *
3757
- * @remarks
3758
- * This type defines the response structure for the 403 status code
3759
- * of the POST DomainForwardsByHostnameByProtocol endpoint.
3760
- * It provides type safety for handling this specific response as defined in the OpenAPI specification.
3761
- *
3762
-
3763
- *
3764
- * @path /v1/domain-forwards/{hostname}/{protocol}
3765
- * @param hostname (path) - Hostname
3766
- *
3767
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response} - The main response type definition
3768
- * @see {@link Problem} - The actual schema type definition
3769
- */
3770
- export type POST_DomainForwardsByHostnameByProtocol_Response_403 = Problem
3771
-
3772
- /**
3773
- * 404 response for POST DomainForwardsByHostnameByProtocol endpoint
3774
- *
3775
- * @remarks
3776
- * This type defines the response structure for the 404 status code
3777
- * of the POST DomainForwardsByHostnameByProtocol endpoint.
3778
- * It provides type safety for handling this specific response as defined in the OpenAPI specification.
3779
- *
3780
-
3781
- *
3782
- * @path /v1/domain-forwards/{hostname}/{protocol}
3783
- * @param hostname (path) - Hostname
3784
- *
3785
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response} - The main response type definition
3786
- * @see {@link Problem} - The actual schema type definition
3787
- */
3788
- export type POST_DomainForwardsByHostnameByProtocol_Response_404 = Problem
3789
-
3790
- /**
3791
- * 409 response for POST DomainForwardsByHostnameByProtocol endpoint
3792
- *
3793
- * @remarks
3794
- * This type defines the response structure for the 409 status code
3795
- * of the POST DomainForwardsByHostnameByProtocol endpoint.
3796
- * It provides type safety for handling this specific response as defined in the OpenAPI specification.
3797
- *
3798
-
3799
- *
3800
- * @path /v1/domain-forwards/{hostname}/{protocol}
3801
- * @param hostname (path) - Hostname
3802
- *
3803
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response} - The main response type definition
3804
- * @see {@link Problem} - The actual schema type definition
3805
- */
3806
- export type POST_DomainForwardsByHostnameByProtocol_Response_409 = Problem
3807
-
3808
- /**
3809
- * 422 response for POST DomainForwardsByHostnameByProtocol endpoint
3810
- *
3811
- * @remarks
3812
- * This type defines the response structure for the 422 status code
3813
- * of the POST DomainForwardsByHostnameByProtocol endpoint.
3814
- * It provides type safety for handling this specific response as defined in the OpenAPI specification.
3815
- *
3816
-
3817
- *
3818
- * @path /v1/domain-forwards/{hostname}/{protocol}
3819
- * @param hostname (path) - Hostname
3820
- *
3821
- * @see {@link POST_DomainForwardsByHostnameByProtocol_Response} - The main response type definition
3822
- * @see {@link HTTPValidationError} - The actual schema type definition
3823
- */
3824
- export type POST_DomainForwardsByHostnameByProtocol_Response_422 = HTTPValidationError
3825
-
3826
3691
  /**
3827
3692
  * Response types for PUT DomainForwardsByHostnameByProtocol endpoint
3828
3693
  *
@@ -4098,7 +3963,8 @@ export type PATCH_DomainForwardsByHostnameEnable_Response_422 = HTTPValidationEr
4098
3963
  /**
4099
3964
  * Response types for GET DomainForwardsMetrics endpoint
4100
3965
  *
4101
- * Metrics
3966
+ * Get domain forward metrics
3967
+ * Retrieves overall metrics for domain forwards including total and unique visit counts.
4102
3968
  *
4103
3969
  * @remarks
4104
3970
  * This type defines all possible response structures for the GET DomainForwardsMetrics endpoint.
@@ -4113,11 +3979,13 @@ export type PATCH_DomainForwardsByHostnameEnable_Response_422 = HTTPValidationEr
4113
3979
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4114
3980
  *
4115
3981
  * @see {@link GET_DomainForwardsMetrics_Response_200} - 200 response type
3982
+ * @see {@link GET_DomainForwardsMetrics_Response_401} - 401 response type
3983
+ * @see {@link GET_DomainForwardsMetrics_Response_403} - 403 response type
4116
3984
  * @see {@link GET_DomainForwardsMetrics_Response_422} - 422 response type
4117
3985
  *
4118
3986
 
4119
3987
  */
4120
- export type GET_DomainForwardsMetrics_Response = GET_DomainForwardsMetrics_Response_200 | GET_DomainForwardsMetrics_Response_422;
3988
+ export type GET_DomainForwardsMetrics_Response = GET_DomainForwardsMetrics_Response_200 | GET_DomainForwardsMetrics_Response_401 | GET_DomainForwardsMetrics_Response_403 | GET_DomainForwardsMetrics_Response_422;
4121
3989
 
4122
3990
  /**
4123
3991
  * 200 response for GET DomainForwardsMetrics endpoint
@@ -4139,6 +4007,46 @@ export type GET_DomainForwardsMetrics_Response = GET_DomainForwardsMetrics_Respo
4139
4007
  */
4140
4008
  export type GET_DomainForwardsMetrics_Response_200 = DomainForwardMetrics
4141
4009
 
4010
+ /**
4011
+ * 401 response for GET DomainForwardsMetrics endpoint
4012
+ *
4013
+ * @remarks
4014
+ * This type defines the response structure for the 401 status code
4015
+ * of the GET DomainForwardsMetrics endpoint.
4016
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4017
+ *
4018
+
4019
+ *
4020
+ * @path /v1/domain-forwards/metrics
4021
+ * @param protocol (query) - Filter by protocol: http or https
4022
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4023
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4024
+ *
4025
+ * @see {@link GET_DomainForwardsMetrics_Response} - The main response type definition
4026
+ * @see {@link Problem} - The actual schema type definition
4027
+ */
4028
+ export type GET_DomainForwardsMetrics_Response_401 = Problem
4029
+
4030
+ /**
4031
+ * 403 response for GET DomainForwardsMetrics endpoint
4032
+ *
4033
+ * @remarks
4034
+ * This type defines the response structure for the 403 status code
4035
+ * of the GET DomainForwardsMetrics endpoint.
4036
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4037
+ *
4038
+
4039
+ *
4040
+ * @path /v1/domain-forwards/metrics
4041
+ * @param protocol (query) - Filter by protocol: http or https
4042
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4043
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4044
+ *
4045
+ * @see {@link GET_DomainForwardsMetrics_Response} - The main response type definition
4046
+ * @see {@link Problem} - The actual schema type definition
4047
+ */
4048
+ export type GET_DomainForwardsMetrics_Response_403 = Problem
4049
+
4142
4050
  /**
4143
4051
  * 422 response for GET DomainForwardsMetrics endpoint
4144
4052
  *
@@ -4162,7 +4070,8 @@ export type GET_DomainForwardsMetrics_Response_422 = HTTPValidationError
4162
4070
  /**
4163
4071
  * Response types for GET DomainForwardsMetricsBrowser endpoint
4164
4072
  *
4165
- * Browser Stats
4073
+ * Get browser statistics
4074
+ * Retrieves visitor traffic broken down by browser type (Chrome, Safari, Firefox, etc.) with total and unique visit counts.
4166
4075
  *
4167
4076
  * @remarks
4168
4077
  * This type defines all possible response structures for the GET DomainForwardsMetricsBrowser endpoint.
@@ -4177,11 +4086,13 @@ export type GET_DomainForwardsMetrics_Response_422 = HTTPValidationError
4177
4086
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4178
4087
  *
4179
4088
  * @see {@link GET_DomainForwardsMetricsBrowser_Response_200} - 200 response type
4089
+ * @see {@link GET_DomainForwardsMetricsBrowser_Response_401} - 401 response type
4090
+ * @see {@link GET_DomainForwardsMetricsBrowser_Response_403} - 403 response type
4180
4091
  * @see {@link GET_DomainForwardsMetricsBrowser_Response_422} - 422 response type
4181
4092
  *
4182
4093
 
4183
4094
  */
4184
- export type GET_DomainForwardsMetricsBrowser_Response = GET_DomainForwardsMetricsBrowser_Response_200 | GET_DomainForwardsMetricsBrowser_Response_422;
4095
+ export type GET_DomainForwardsMetricsBrowser_Response = GET_DomainForwardsMetricsBrowser_Response_200 | GET_DomainForwardsMetricsBrowser_Response_401 | GET_DomainForwardsMetricsBrowser_Response_403 | GET_DomainForwardsMetricsBrowser_Response_422;
4185
4096
 
4186
4097
  /**
4187
4098
  * 200 response for GET DomainForwardsMetricsBrowser endpoint
@@ -4203,6 +4114,46 @@ export type GET_DomainForwardsMetricsBrowser_Response = GET_DomainForwardsMetric
4203
4114
  */
4204
4115
  export type GET_DomainForwardsMetricsBrowser_Response_200 = DomainForwardBrowserStats
4205
4116
 
4117
+ /**
4118
+ * 401 response for GET DomainForwardsMetricsBrowser endpoint
4119
+ *
4120
+ * @remarks
4121
+ * This type defines the response structure for the 401 status code
4122
+ * of the GET DomainForwardsMetricsBrowser endpoint.
4123
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4124
+ *
4125
+
4126
+ *
4127
+ * @path /v1/domain-forwards/metrics/browser
4128
+ * @param protocol (query) - Filter by protocol: http or https
4129
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4130
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4131
+ *
4132
+ * @see {@link GET_DomainForwardsMetricsBrowser_Response} - The main response type definition
4133
+ * @see {@link Problem} - The actual schema type definition
4134
+ */
4135
+ export type GET_DomainForwardsMetricsBrowser_Response_401 = Problem
4136
+
4137
+ /**
4138
+ * 403 response for GET DomainForwardsMetricsBrowser endpoint
4139
+ *
4140
+ * @remarks
4141
+ * This type defines the response structure for the 403 status code
4142
+ * of the GET DomainForwardsMetricsBrowser endpoint.
4143
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4144
+ *
4145
+
4146
+ *
4147
+ * @path /v1/domain-forwards/metrics/browser
4148
+ * @param protocol (query) - Filter by protocol: http or https
4149
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4150
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4151
+ *
4152
+ * @see {@link GET_DomainForwardsMetricsBrowser_Response} - The main response type definition
4153
+ * @see {@link Problem} - The actual schema type definition
4154
+ */
4155
+ export type GET_DomainForwardsMetricsBrowser_Response_403 = Problem
4156
+
4206
4157
  /**
4207
4158
  * 422 response for GET DomainForwardsMetricsBrowser endpoint
4208
4159
  *
@@ -4226,7 +4177,8 @@ export type GET_DomainForwardsMetricsBrowser_Response_422 = HTTPValidationError
4226
4177
  /**
4227
4178
  * Response types for GET DomainForwardsMetricsGeo endpoint
4228
4179
  *
4229
- * Geo Stats
4180
+ * Get geographic statistics
4181
+ * Retrieves visitor traffic broken down by geographic location (country code) with visit counts.
4230
4182
  *
4231
4183
  * @remarks
4232
4184
  * This type defines all possible response structures for the GET DomainForwardsMetricsGeo endpoint.
@@ -4241,11 +4193,13 @@ export type GET_DomainForwardsMetricsBrowser_Response_422 = HTTPValidationError
4241
4193
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4242
4194
  *
4243
4195
  * @see {@link GET_DomainForwardsMetricsGeo_Response_200} - 200 response type
4196
+ * @see {@link GET_DomainForwardsMetricsGeo_Response_401} - 401 response type
4197
+ * @see {@link GET_DomainForwardsMetricsGeo_Response_403} - 403 response type
4244
4198
  * @see {@link GET_DomainForwardsMetricsGeo_Response_422} - 422 response type
4245
4199
  *
4246
4200
 
4247
4201
  */
4248
- export type GET_DomainForwardsMetricsGeo_Response = GET_DomainForwardsMetricsGeo_Response_200 | GET_DomainForwardsMetricsGeo_Response_422;
4202
+ export type GET_DomainForwardsMetricsGeo_Response = GET_DomainForwardsMetricsGeo_Response_200 | GET_DomainForwardsMetricsGeo_Response_401 | GET_DomainForwardsMetricsGeo_Response_403 | GET_DomainForwardsMetricsGeo_Response_422;
4249
4203
 
4250
4204
  /**
4251
4205
  * 200 response for GET DomainForwardsMetricsGeo endpoint
@@ -4267,6 +4221,46 @@ export type GET_DomainForwardsMetricsGeo_Response = GET_DomainForwardsMetricsGeo
4267
4221
  */
4268
4222
  export type GET_DomainForwardsMetricsGeo_Response_200 = DomainForwardGeoStats
4269
4223
 
4224
+ /**
4225
+ * 401 response for GET DomainForwardsMetricsGeo endpoint
4226
+ *
4227
+ * @remarks
4228
+ * This type defines the response structure for the 401 status code
4229
+ * of the GET DomainForwardsMetricsGeo endpoint.
4230
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4231
+ *
4232
+
4233
+ *
4234
+ * @path /v1/domain-forwards/metrics/geo
4235
+ * @param protocol (query) - Filter by protocol: http or https
4236
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4237
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4238
+ *
4239
+ * @see {@link GET_DomainForwardsMetricsGeo_Response} - The main response type definition
4240
+ * @see {@link Problem} - The actual schema type definition
4241
+ */
4242
+ export type GET_DomainForwardsMetricsGeo_Response_401 = Problem
4243
+
4244
+ /**
4245
+ * 403 response for GET DomainForwardsMetricsGeo endpoint
4246
+ *
4247
+ * @remarks
4248
+ * This type defines the response structure for the 403 status code
4249
+ * of the GET DomainForwardsMetricsGeo endpoint.
4250
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4251
+ *
4252
+
4253
+ *
4254
+ * @path /v1/domain-forwards/metrics/geo
4255
+ * @param protocol (query) - Filter by protocol: http or https
4256
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4257
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4258
+ *
4259
+ * @see {@link GET_DomainForwardsMetricsGeo_Response} - The main response type definition
4260
+ * @see {@link Problem} - The actual schema type definition
4261
+ */
4262
+ export type GET_DomainForwardsMetricsGeo_Response_403 = Problem
4263
+
4270
4264
  /**
4271
4265
  * 422 response for GET DomainForwardsMetricsGeo endpoint
4272
4266
  *
@@ -4290,7 +4284,8 @@ export type GET_DomainForwardsMetricsGeo_Response_422 = HTTPValidationError
4290
4284
  /**
4291
4285
  * Response types for GET DomainForwardsMetricsPlatform endpoint
4292
4286
  *
4293
- * Platform Stats
4287
+ * Get platform statistics
4288
+ * Retrieves visitor traffic broken down by platform (Windows, Macintosh, iOS, Android, Linux) with total and unique visit counts.
4294
4289
  *
4295
4290
  * @remarks
4296
4291
  * This type defines all possible response structures for the GET DomainForwardsMetricsPlatform endpoint.
@@ -4305,11 +4300,13 @@ export type GET_DomainForwardsMetricsGeo_Response_422 = HTTPValidationError
4305
4300
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4306
4301
  *
4307
4302
  * @see {@link GET_DomainForwardsMetricsPlatform_Response_200} - 200 response type
4303
+ * @see {@link GET_DomainForwardsMetricsPlatform_Response_401} - 401 response type
4304
+ * @see {@link GET_DomainForwardsMetricsPlatform_Response_403} - 403 response type
4308
4305
  * @see {@link GET_DomainForwardsMetricsPlatform_Response_422} - 422 response type
4309
4306
  *
4310
4307
 
4311
4308
  */
4312
- export type GET_DomainForwardsMetricsPlatform_Response = GET_DomainForwardsMetricsPlatform_Response_200 | GET_DomainForwardsMetricsPlatform_Response_422;
4309
+ export type GET_DomainForwardsMetricsPlatform_Response = GET_DomainForwardsMetricsPlatform_Response_200 | GET_DomainForwardsMetricsPlatform_Response_401 | GET_DomainForwardsMetricsPlatform_Response_403 | GET_DomainForwardsMetricsPlatform_Response_422;
4313
4310
 
4314
4311
  /**
4315
4312
  * 200 response for GET DomainForwardsMetricsPlatform endpoint
@@ -4331,6 +4328,46 @@ export type GET_DomainForwardsMetricsPlatform_Response = GET_DomainForwardsMetri
4331
4328
  */
4332
4329
  export type GET_DomainForwardsMetricsPlatform_Response_200 = DomainForwardPlatformStats
4333
4330
 
4331
+ /**
4332
+ * 401 response for GET DomainForwardsMetricsPlatform endpoint
4333
+ *
4334
+ * @remarks
4335
+ * This type defines the response structure for the 401 status code
4336
+ * of the GET DomainForwardsMetricsPlatform endpoint.
4337
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4338
+ *
4339
+
4340
+ *
4341
+ * @path /v1/domain-forwards/metrics/platform
4342
+ * @param protocol (query) - Filter by protocol: http or https
4343
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4344
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4345
+ *
4346
+ * @see {@link GET_DomainForwardsMetricsPlatform_Response} - The main response type definition
4347
+ * @see {@link Problem} - The actual schema type definition
4348
+ */
4349
+ export type GET_DomainForwardsMetricsPlatform_Response_401 = Problem
4350
+
4351
+ /**
4352
+ * 403 response for GET DomainForwardsMetricsPlatform endpoint
4353
+ *
4354
+ * @remarks
4355
+ * This type defines the response structure for the 403 status code
4356
+ * of the GET DomainForwardsMetricsPlatform endpoint.
4357
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4358
+ *
4359
+
4360
+ *
4361
+ * @path /v1/domain-forwards/metrics/platform
4362
+ * @param protocol (query) - Filter by protocol: http or https
4363
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4364
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4365
+ *
4366
+ * @see {@link GET_DomainForwardsMetricsPlatform_Response} - The main response type definition
4367
+ * @see {@link Problem} - The actual schema type definition
4368
+ */
4369
+ export type GET_DomainForwardsMetricsPlatform_Response_403 = Problem
4370
+
4334
4371
  /**
4335
4372
  * 422 response for GET DomainForwardsMetricsPlatform endpoint
4336
4373
  *
@@ -4354,7 +4391,8 @@ export type GET_DomainForwardsMetricsPlatform_Response_422 = HTTPValidationError
4354
4391
  /**
4355
4392
  * Response types for GET DomainForwardsMetricsReferrer endpoint
4356
4393
  *
4357
- * Referrer Stats
4394
+ * Get referrer statistics
4395
+ * Retrieves visitor referral sources (where traffic came from) with total and unique visit counts.
4358
4396
  *
4359
4397
  * @remarks
4360
4398
  * This type defines all possible response structures for the GET DomainForwardsMetricsReferrer endpoint.
@@ -4369,11 +4407,13 @@ export type GET_DomainForwardsMetricsPlatform_Response_422 = HTTPValidationError
4369
4407
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4370
4408
  *
4371
4409
  * @see {@link GET_DomainForwardsMetricsReferrer_Response_200} - 200 response type
4410
+ * @see {@link GET_DomainForwardsMetricsReferrer_Response_401} - 401 response type
4411
+ * @see {@link GET_DomainForwardsMetricsReferrer_Response_403} - 403 response type
4372
4412
  * @see {@link GET_DomainForwardsMetricsReferrer_Response_422} - 422 response type
4373
4413
  *
4374
4414
 
4375
4415
  */
4376
- export type GET_DomainForwardsMetricsReferrer_Response = GET_DomainForwardsMetricsReferrer_Response_200 | GET_DomainForwardsMetricsReferrer_Response_422;
4416
+ export type GET_DomainForwardsMetricsReferrer_Response = GET_DomainForwardsMetricsReferrer_Response_200 | GET_DomainForwardsMetricsReferrer_Response_401 | GET_DomainForwardsMetricsReferrer_Response_403 | GET_DomainForwardsMetricsReferrer_Response_422;
4377
4417
 
4378
4418
  /**
4379
4419
  * 200 response for GET DomainForwardsMetricsReferrer endpoint
@@ -4395,6 +4435,46 @@ export type GET_DomainForwardsMetricsReferrer_Response = GET_DomainForwardsMetri
4395
4435
  */
4396
4436
  export type GET_DomainForwardsMetricsReferrer_Response_200 = DomainForwardReferrerStats
4397
4437
 
4438
+ /**
4439
+ * 401 response for GET DomainForwardsMetricsReferrer endpoint
4440
+ *
4441
+ * @remarks
4442
+ * This type defines the response structure for the 401 status code
4443
+ * of the GET DomainForwardsMetricsReferrer endpoint.
4444
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4445
+ *
4446
+
4447
+ *
4448
+ * @path /v1/domain-forwards/metrics/referrer
4449
+ * @param protocol (query) - Filter by protocol: http or https
4450
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4451
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4452
+ *
4453
+ * @see {@link GET_DomainForwardsMetricsReferrer_Response} - The main response type definition
4454
+ * @see {@link Problem} - The actual schema type definition
4455
+ */
4456
+ export type GET_DomainForwardsMetricsReferrer_Response_401 = Problem
4457
+
4458
+ /**
4459
+ * 403 response for GET DomainForwardsMetricsReferrer endpoint
4460
+ *
4461
+ * @remarks
4462
+ * This type defines the response structure for the 403 status code
4463
+ * of the GET DomainForwardsMetricsReferrer endpoint.
4464
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4465
+ *
4466
+
4467
+ *
4468
+ * @path /v1/domain-forwards/metrics/referrer
4469
+ * @param protocol (query) - Filter by protocol: http or https
4470
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4471
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4472
+ *
4473
+ * @see {@link GET_DomainForwardsMetricsReferrer_Response} - The main response type definition
4474
+ * @see {@link Problem} - The actual schema type definition
4475
+ */
4476
+ export type GET_DomainForwardsMetricsReferrer_Response_403 = Problem
4477
+
4398
4478
  /**
4399
4479
  * 422 response for GET DomainForwardsMetricsReferrer endpoint
4400
4480
  *
@@ -4418,7 +4498,8 @@ export type GET_DomainForwardsMetricsReferrer_Response_422 = HTTPValidationError
4418
4498
  /**
4419
4499
  * Response types for GET DomainForwardsMetricsStatusCode endpoint
4420
4500
  *
4421
- * Status Code Stats
4501
+ * Get HTTP status code statistics
4502
+ * Retrieves distribution of HTTP redirect status codes (301, 302, 307, 308) used across forwards.
4422
4503
  *
4423
4504
  * @remarks
4424
4505
  * This type defines all possible response structures for the GET DomainForwardsMetricsStatusCode endpoint.
@@ -4433,11 +4514,13 @@ export type GET_DomainForwardsMetricsReferrer_Response_422 = HTTPValidationError
4433
4514
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4434
4515
  *
4435
4516
  * @see {@link GET_DomainForwardsMetricsStatusCode_Response_200} - 200 response type
4517
+ * @see {@link GET_DomainForwardsMetricsStatusCode_Response_401} - 401 response type
4518
+ * @see {@link GET_DomainForwardsMetricsStatusCode_Response_403} - 403 response type
4436
4519
  * @see {@link GET_DomainForwardsMetricsStatusCode_Response_422} - 422 response type
4437
4520
  *
4438
4521
 
4439
4522
  */
4440
- export type GET_DomainForwardsMetricsStatusCode_Response = GET_DomainForwardsMetricsStatusCode_Response_200 | GET_DomainForwardsMetricsStatusCode_Response_422;
4523
+ export type GET_DomainForwardsMetricsStatusCode_Response = GET_DomainForwardsMetricsStatusCode_Response_200 | GET_DomainForwardsMetricsStatusCode_Response_401 | GET_DomainForwardsMetricsStatusCode_Response_403 | GET_DomainForwardsMetricsStatusCode_Response_422;
4441
4524
 
4442
4525
  /**
4443
4526
  * 200 response for GET DomainForwardsMetricsStatusCode endpoint
@@ -4459,6 +4542,46 @@ export type GET_DomainForwardsMetricsStatusCode_Response = GET_DomainForwardsMet
4459
4542
  */
4460
4543
  export type GET_DomainForwardsMetricsStatusCode_Response_200 = DomainForwardStatusCodeStats
4461
4544
 
4545
+ /**
4546
+ * 401 response for GET DomainForwardsMetricsStatusCode endpoint
4547
+ *
4548
+ * @remarks
4549
+ * This type defines the response structure for the 401 status code
4550
+ * of the GET DomainForwardsMetricsStatusCode endpoint.
4551
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4552
+ *
4553
+
4554
+ *
4555
+ * @path /v1/domain-forwards/metrics/status-code
4556
+ * @param protocol (query) - Filter by protocol: http or https
4557
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4558
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4559
+ *
4560
+ * @see {@link GET_DomainForwardsMetricsStatusCode_Response} - The main response type definition
4561
+ * @see {@link Problem} - The actual schema type definition
4562
+ */
4563
+ export type GET_DomainForwardsMetricsStatusCode_Response_401 = Problem
4564
+
4565
+ /**
4566
+ * 403 response for GET DomainForwardsMetricsStatusCode endpoint
4567
+ *
4568
+ * @remarks
4569
+ * This type defines the response structure for the 403 status code
4570
+ * of the GET DomainForwardsMetricsStatusCode endpoint.
4571
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4572
+ *
4573
+
4574
+ *
4575
+ * @path /v1/domain-forwards/metrics/status-code
4576
+ * @param protocol (query) - Filter by protocol: http or https
4577
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4578
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4579
+ *
4580
+ * @see {@link GET_DomainForwardsMetricsStatusCode_Response} - The main response type definition
4581
+ * @see {@link Problem} - The actual schema type definition
4582
+ */
4583
+ export type GET_DomainForwardsMetricsStatusCode_Response_403 = Problem
4584
+
4462
4585
  /**
4463
4586
  * 422 response for GET DomainForwardsMetricsStatusCode endpoint
4464
4587
  *
@@ -4482,7 +4605,8 @@ export type GET_DomainForwardsMetricsStatusCode_Response_422 = HTTPValidationErr
4482
4605
  /**
4483
4606
  * Response types for GET DomainForwardsMetricsTimeSeries endpoint
4484
4607
  *
4485
- * Time Series
4608
+ * Get domain forward time series metrics
4609
+ * Retrieves visit counts bucketed by time intervals (hourly, daily) for the specified time range.
4486
4610
  *
4487
4611
  * @remarks
4488
4612
  * This type defines all possible response structures for the GET DomainForwardsMetricsTimeSeries endpoint.
@@ -4497,11 +4621,13 @@ export type GET_DomainForwardsMetricsStatusCode_Response_422 = HTTPValidationErr
4497
4621
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4498
4622
  *
4499
4623
  * @see {@link GET_DomainForwardsMetricsTimeSeries_Response_200} - 200 response type
4624
+ * @see {@link GET_DomainForwardsMetricsTimeSeries_Response_401} - 401 response type
4625
+ * @see {@link GET_DomainForwardsMetricsTimeSeries_Response_403} - 403 response type
4500
4626
  * @see {@link GET_DomainForwardsMetricsTimeSeries_Response_422} - 422 response type
4501
4627
  *
4502
4628
 
4503
4629
  */
4504
- export type GET_DomainForwardsMetricsTimeSeries_Response = GET_DomainForwardsMetricsTimeSeries_Response_200 | GET_DomainForwardsMetricsTimeSeries_Response_422;
4630
+ export type GET_DomainForwardsMetricsTimeSeries_Response = GET_DomainForwardsMetricsTimeSeries_Response_200 | GET_DomainForwardsMetricsTimeSeries_Response_401 | GET_DomainForwardsMetricsTimeSeries_Response_403 | GET_DomainForwardsMetricsTimeSeries_Response_422;
4505
4631
 
4506
4632
  /**
4507
4633
  * 200 response for GET DomainForwardsMetricsTimeSeries endpoint
@@ -4523,6 +4649,46 @@ export type GET_DomainForwardsMetricsTimeSeries_Response = GET_DomainForwardsMet
4523
4649
  */
4524
4650
  export type GET_DomainForwardsMetricsTimeSeries_Response_200 = DomainForwardMetricsTimeSeries
4525
4651
 
4652
+ /**
4653
+ * 401 response for GET DomainForwardsMetricsTimeSeries endpoint
4654
+ *
4655
+ * @remarks
4656
+ * This type defines the response structure for the 401 status code
4657
+ * of the GET DomainForwardsMetricsTimeSeries endpoint.
4658
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4659
+ *
4660
+
4661
+ *
4662
+ * @path /v1/domain-forwards/metrics/time-series
4663
+ * @param protocol (query) - Filter by protocol: http or https
4664
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4665
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4666
+ *
4667
+ * @see {@link GET_DomainForwardsMetricsTimeSeries_Response} - The main response type definition
4668
+ * @see {@link Problem} - The actual schema type definition
4669
+ */
4670
+ export type GET_DomainForwardsMetricsTimeSeries_Response_401 = Problem
4671
+
4672
+ /**
4673
+ * 403 response for GET DomainForwardsMetricsTimeSeries endpoint
4674
+ *
4675
+ * @remarks
4676
+ * This type defines the response structure for the 403 status code
4677
+ * of the GET DomainForwardsMetricsTimeSeries endpoint.
4678
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4679
+ *
4680
+
4681
+ *
4682
+ * @path /v1/domain-forwards/metrics/time-series
4683
+ * @param protocol (query) - Filter by protocol: http or https
4684
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4685
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4686
+ *
4687
+ * @see {@link GET_DomainForwardsMetricsTimeSeries_Response} - The main response type definition
4688
+ * @see {@link Problem} - The actual schema type definition
4689
+ */
4690
+ export type GET_DomainForwardsMetricsTimeSeries_Response_403 = Problem
4691
+
4526
4692
  /**
4527
4693
  * 422 response for GET DomainForwardsMetricsTimeSeries endpoint
4528
4694
  *
@@ -4546,7 +4712,8 @@ export type GET_DomainForwardsMetricsTimeSeries_Response_422 = HTTPValidationErr
4546
4712
  /**
4547
4713
  * Response types for GET DomainForwardsMetricsUserAgent endpoint
4548
4714
  *
4549
- * User Agent Stats
4715
+ * Get user agent statistics
4716
+ * Retrieves visitor traffic broken down by user agent string with total and unique visit counts.
4550
4717
  *
4551
4718
  * @remarks
4552
4719
  * This type defines all possible response structures for the GET DomainForwardsMetricsUserAgent endpoint.
@@ -4561,11 +4728,13 @@ export type GET_DomainForwardsMetricsTimeSeries_Response_422 = HTTPValidationErr
4561
4728
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4562
4729
  *
4563
4730
  * @see {@link GET_DomainForwardsMetricsUserAgent_Response_200} - 200 response type
4731
+ * @see {@link GET_DomainForwardsMetricsUserAgent_Response_401} - 401 response type
4732
+ * @see {@link GET_DomainForwardsMetricsUserAgent_Response_403} - 403 response type
4564
4733
  * @see {@link GET_DomainForwardsMetricsUserAgent_Response_422} - 422 response type
4565
4734
  *
4566
4735
 
4567
4736
  */
4568
- export type GET_DomainForwardsMetricsUserAgent_Response = GET_DomainForwardsMetricsUserAgent_Response_200 | GET_DomainForwardsMetricsUserAgent_Response_422;
4737
+ export type GET_DomainForwardsMetricsUserAgent_Response = GET_DomainForwardsMetricsUserAgent_Response_200 | GET_DomainForwardsMetricsUserAgent_Response_401 | GET_DomainForwardsMetricsUserAgent_Response_403 | GET_DomainForwardsMetricsUserAgent_Response_422;
4569
4738
 
4570
4739
  /**
4571
4740
  * 200 response for GET DomainForwardsMetricsUserAgent endpoint
@@ -4587,6 +4756,46 @@ export type GET_DomainForwardsMetricsUserAgent_Response = GET_DomainForwardsMetr
4587
4756
  */
4588
4757
  export type GET_DomainForwardsMetricsUserAgent_Response_200 = DomainForwardUserAgentStats
4589
4758
 
4759
+ /**
4760
+ * 401 response for GET DomainForwardsMetricsUserAgent endpoint
4761
+ *
4762
+ * @remarks
4763
+ * This type defines the response structure for the 401 status code
4764
+ * of the GET DomainForwardsMetricsUserAgent endpoint.
4765
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4766
+ *
4767
+
4768
+ *
4769
+ * @path /v1/domain-forwards/metrics/user-agent
4770
+ * @param protocol (query) - Filter by protocol: http or https
4771
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4772
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4773
+ *
4774
+ * @see {@link GET_DomainForwardsMetricsUserAgent_Response} - The main response type definition
4775
+ * @see {@link Problem} - The actual schema type definition
4776
+ */
4777
+ export type GET_DomainForwardsMetricsUserAgent_Response_401 = Problem
4778
+
4779
+ /**
4780
+ * 403 response for GET DomainForwardsMetricsUserAgent endpoint
4781
+ *
4782
+ * @remarks
4783
+ * This type defines the response structure for the 403 status code
4784
+ * of the GET DomainForwardsMetricsUserAgent endpoint.
4785
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4786
+ *
4787
+
4788
+ *
4789
+ * @path /v1/domain-forwards/metrics/user-agent
4790
+ * @param protocol (query) - Filter by protocol: http or https
4791
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4792
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4793
+ *
4794
+ * @see {@link GET_DomainForwardsMetricsUserAgent_Response} - The main response type definition
4795
+ * @see {@link Problem} - The actual schema type definition
4796
+ */
4797
+ export type GET_DomainForwardsMetricsUserAgent_Response_403 = Problem
4798
+
4590
4799
  /**
4591
4800
  * 422 response for GET DomainForwardsMetricsUserAgent endpoint
4592
4801
  *
@@ -4610,7 +4819,8 @@ export type GET_DomainForwardsMetricsUserAgent_Response_422 = HTTPValidationErro
4610
4819
  /**
4611
4820
  * Response types for GET DomainForwardsMetricsVisitsByKey endpoint
4612
4821
  *
4613
- * Visits By Key
4822
+ * Get visits grouped by key
4823
+ * Retrieves visit metrics grouped by a specified key (url, fqdn, domain, or forward) with total and unique visit counts.
4614
4824
  *
4615
4825
  * @remarks
4616
4826
  * This type defines all possible response structures for the GET DomainForwardsMetricsVisitsByKey endpoint.
@@ -4626,11 +4836,13 @@ export type GET_DomainForwardsMetricsUserAgent_Response_422 = HTTPValidationErro
4626
4836
  * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4627
4837
  *
4628
4838
  * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response_200} - 200 response type
4839
+ * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response_401} - 401 response type
4840
+ * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response_403} - 403 response type
4629
4841
  * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response_422} - 422 response type
4630
4842
  *
4631
4843
 
4632
4844
  */
4633
- export type GET_DomainForwardsMetricsVisitsByKey_Response = GET_DomainForwardsMetricsVisitsByKey_Response_200 | GET_DomainForwardsMetricsVisitsByKey_Response_422;
4845
+ export type GET_DomainForwardsMetricsVisitsByKey_Response = GET_DomainForwardsMetricsVisitsByKey_Response_200 | GET_DomainForwardsMetricsVisitsByKey_Response_401 | GET_DomainForwardsMetricsVisitsByKey_Response_403 | GET_DomainForwardsMetricsVisitsByKey_Response_422;
4634
4846
 
4635
4847
  /**
4636
4848
  * 200 response for GET DomainForwardsMetricsVisitsByKey endpoint
@@ -4653,6 +4865,48 @@ export type GET_DomainForwardsMetricsVisitsByKey_Response = GET_DomainForwardsMe
4653
4865
  */
4654
4866
  export type GET_DomainForwardsMetricsVisitsByKey_Response_200 = DomainForwardVisitsByKey
4655
4867
 
4868
+ /**
4869
+ * 401 response for GET DomainForwardsMetricsVisitsByKey endpoint
4870
+ *
4871
+ * @remarks
4872
+ * This type defines the response structure for the 401 status code
4873
+ * of the GET DomainForwardsMetricsVisitsByKey endpoint.
4874
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4875
+ *
4876
+
4877
+ *
4878
+ * @path /v1/domain-forwards/metrics/visits-by-key
4879
+ * @param grouping (query) - Grouping key: url, fqdn, domain, or forward
4880
+ * @param protocol (query) - Filter by protocol: http or https
4881
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4882
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4883
+ *
4884
+ * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response} - The main response type definition
4885
+ * @see {@link Problem} - The actual schema type definition
4886
+ */
4887
+ export type GET_DomainForwardsMetricsVisitsByKey_Response_401 = Problem
4888
+
4889
+ /**
4890
+ * 403 response for GET DomainForwardsMetricsVisitsByKey endpoint
4891
+ *
4892
+ * @remarks
4893
+ * This type defines the response structure for the 403 status code
4894
+ * of the GET DomainForwardsMetricsVisitsByKey endpoint.
4895
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
4896
+ *
4897
+
4898
+ *
4899
+ * @path /v1/domain-forwards/metrics/visits-by-key
4900
+ * @param grouping (query) - Grouping key: url, fqdn, domain, or forward
4901
+ * @param protocol (query) - Filter by protocol: http or https
4902
+ * @param time_range (query) - Time range: 1h, 1d, 7d, or 30d
4903
+ * @param exclude_bots (query) - Exclude platform values: Unknown, Bot
4904
+ *
4905
+ * @see {@link GET_DomainForwardsMetricsVisitsByKey_Response} - The main response type definition
4906
+ * @see {@link Problem} - The actual schema type definition
4907
+ */
4908
+ export type GET_DomainForwardsMetricsVisitsByKey_Response_403 = Problem
4909
+
4656
4910
  /**
4657
4911
  * 422 response for GET DomainForwardsMetricsVisitsByKey endpoint
4658
4912
  *