docs: /v1/data/topics

codeforjapan · Oct 25, 2024 · 20f0874 · 20f0874
1 parent 93e61bf
commit 20f0874
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 2 deletions.
diff --git a/api/birdxplorer_api/routers/data.py b/api/birdxplorer_api/routers/data.py
@@ -21,7 +21,7 @@
 )
 from birdxplorer_common.storage import Storage
 
-from .openapi_doc import V1DataNotesDocs, V1DataPostsDocs
+from .openapi_doc import V1DataNotesDocs, V1DataPostsDocs, V1DataTopicsDocs
 
 
 class TopicListResponse(BaseModel):
@@ -67,7 +67,7 @@ def get_user_enrollment_by_participant_id(
             raise ValueError(f"participant_id={participant_id} not found")
         return res
 
-    @router.get("/topics", response_model=TopicListResponse)
+    @router.get("/topics", description=V1DataTopicsDocs.description, response_model=TopicListResponse)
     def get_topics() -> TopicListResponse:
         return TopicListResponse(data=list(storage.get_topics()))
 

diff --git a/api/birdxplorer_api/routers/openapi_doc.py b/api/birdxplorer_api/routers/openapi_doc.py
@@ -348,3 +348,7 @@ class FastAPIEndpointDocs(Generic[_KEY]):
     },
 )
 
+V1DataTopicsDocs = FastAPIEndpointDocs(
+    "自動分類されたコミュニティノートのトピックを取得するエンドポイント",
+    {},
+)
-Original file line number
+Diff line change
@@ Expand Up / @@ -348,3 +348,7 @@ class FastAPIEndpointDocs(Generic[_KEY]): @@
         },
     )
+    V1DataTopicsDocs = FastAPIEndpointDocs(
+        "自動分類されたコミュニティノートのトピックを取得するエンドポイント",
+        {},
+    )