From ec6e0bea07cb387494397a10f8a9e875ea27e102 Mon Sep 17 00:00:00 2001
From: Simon Zolin <s.zolin@adguard.com>
Date: Thu, 18 Jun 2020 13:49:52 +0300
Subject: [PATCH] * openapi: describe top_* array entries in /stats

Squashed commit of the following:

commit d0b640cb36985c82f1020de99fba2201a1c54738
Author: Simon Zolin <s.zolin@adguard.com>
Date:   Thu Jun 18 11:53:16 2020 +0300

    * openapi: describe top_* array entries in /stats
---
 openapi/openapi.yaml | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/openapi/openapi.yaml b/openapi/openapi.yaml
index b30ccc2e..15e2963b 100644
--- a/openapi/openapi.yaml
+++ b/openapi/openapi.yaml
@@ -1213,15 +1213,15 @@ components:
                 top_queried_domains:
                     type: array
                     items:
-                        type: object
+                        $ref: "#/components/schemas/TopArrayEntry"
                 top_clients:
                     type: array
                     items:
-                        type: object
+                        $ref: "#/components/schemas/TopArrayEntry"
                 top_blocked_domains:
                     type: array
                     items:
-                        type: object
+                        $ref: "#/components/schemas/TopArrayEntry"
                 dns_queries:
                     type: array
                     items:
@@ -1238,6 +1238,12 @@ components:
                     type: array
                     items:
                         type: integer
+        TopArrayEntry:
+            type: object
+            description: Represent the number of hits per key (domain or client IP)
+            properties:
+                domain_or_ip:
+                    type: integer
         StatsConfig:
             type: object
             description: Statistics configuration