feat: add key-get.json

Author: techpro-aimlapi

docs/api-references/service-endpoints/key-get.json

@@ -0,0 +1,120 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "title": "AIML API",
+    "version": "1.0.0"
+  },
+  "servers": [
+    {
+      "url": "https://api.aimlapi.com"
+    }
+  ],
+  "paths": {
+    "/key": {
+      "get": {
+        "operationId": "KeysController_getLatestKey_v1",
+        "responses": {
+          "200": {
+            "description": "Retrieve parameters of the latest API key.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "type": "string",
+                          "nullable": true,
+                          "description": "API key name.",
+                          "example": "test"
+                        },
+                        "disabled": {
+                          "type": "boolean",
+                          "description": "Indicates whether the key is disabled.",
+                          "example": false
+                        },
+                        "prefix": {
+                          "type": "string",
+                          "description": "Key prefix.",
+                          "example": "325b9499"
+                        },
+                        "scopes": {
+                          "type": "array",
+                          "nullable": true,
+                          "description": "Effective scopes assigned to the key.",
+                          "items": {
+                            "type": "string"
+                          },
+                          "example": null
+                        },
+                        "limit": {
+                          "nullable": true,
+                          "type": "object",
+                          "description": "Spending limits configuration (if set).",
+                          "properties": {
+                            "retention": {
+                              "type": "string",
+                              "example": "week"
+                            },
+                            "threshold": {
+                              "type": "number",
+                              "example": 25
+                            }
+                          }
+                        },
+                        "created_at": {
+                          "type": "string",
+                          "format": "date-time",
+                          "description": "Creation timestamp (UTC).",
+                          "example": "2026-02-18T06:57:29.232Z"
+                        },
+                        "updated_at": {
+                          "type": "string",
+                          "format": "date-time",
+                          "description": "Last update timestamp (UTC).",
+                          "example": "2026-02-18T06:57:29.232Z"
+                        },
+                        "monthly_usage": {
+                          "type": "number",
+                          "description": "Current monthly usage amount.",
+                          "example": 0
+                        }
+                      },
+                      "required": [
+                        "disabled",
+                        "prefix",
+                        "created_at",
+                        "updated_at",
+                        "monthly_usage"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        "x-hideTryItPanel": false,
+        "x-codeSamples": [
+          {
+            "lang": "cURL",
+            "source": "curl -L \\\n  --request GET \\\n  --url 'https://api.aimlapi.com/v1/key' \\\n  --header 'Authorization: Bearer <YOUR_MANAGEMENT_KEY>'"
+          },
+          {
+            "lang": "JavaScript",
+            "source": "async function main() {\n  const response = await fetch(\"https://api.aimlapi.com/v1/key\", {\n    method: \"GET\",\n    headers: {\n      \"Authorization\": \"Bearer <YOUR_MANAGEMENT_KEY>\"\n    }\n  });\n\n  const data = await response.json();\n  console.log(JSON.stringify(data, null, 2));\n}\n\nmain();"
+          },
+          {
+            "lang": "Python",
+            "source": "import requests\nimport json\n\n\ndef main():\n    url = \"https://api.aimlapi.com/v1/key\"\n    headers = {\n        \"Authorization\": \"Bearer <YOUR_MANAGEMENT_KEY>\"\n    }\n\n    response = requests.get(url, headers=headers)\n    data = response.json()\n    print(json.dumps(data, indent=2, ensure_ascii=False))\n\n\nif __name__ == \"__main__\":\n    main()"
+          }
+        ]
+      }
+    }
+  }
+}