{
    "openapi": "3.1.0",
    "info": {
        "title": "Client Info API",
        "version": "v1",
        "description": "Browser, operating system, device type and IP details directly from the request headers, fully server-side without external services. Free."
    },
    "servers": [
        {
            "url": "https://api.flowdata.one/v1",
            "description": "FlowData API"
        }
    ],
    "security": [
        {
            "bearerAuth": []
        }
    ],
    "tags": [
        {
            "name": "endpoint",
            "description": "API endpoint"
        }
    ],
    "paths": {
        "/client-info": {
            "get": {
                "operationId": "client-info-get",
                "summary": "Get client information",
                "description": "Reads the request headers of the requesting client and answers with the detected information. No parameters needed.",
                "tags": [
                    "endpoint"
                ],
                "responses": {
                    "200": {
                        "description": "Successful response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                },
                                "example": {
                                    "ipString": "203.0.113.42",
                                    "ipNumeric": 3405803818,
                                    "ipType": "IPv4",
                                    "isBehindProxy": false,
                                    "device": "Mac",
                                    "os": "Mac OS X 12.6.0",
                                    "userAgent": "Chrome 120.0.0",
                                    "family": "Chrome",
                                    "versionMajor": "120",
                                    "versionMinor": "0",
                                    "versionPatch": "0",
                                    "isSpider": false,
                                    "isMobile": false,
                                    "userAgentDisplay": "Mac OS X 12.6.0 Mac Chrome 120.0.0",
                                    "userAgentRaw": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
                                    "userLanguages": [
                                        "de-DE",
                                        "de",
                                        "en-US",
                                        "en"
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "Error response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "securitySchemes": {
            "bearerAuth": {
                "type": "http",
                "scheme": "bearer",
                "description": "FlowData key as Authorization: Bearer fd_…"
            }
        },
        "schemas": {
            "Error": {
                "type": "object",
                "required": [
                    "error"
                ],
                "properties": {
                    "error": {
                        "type": "object",
                        "properties": {
                            "code": {
                                "type": "string"
                            },
                            "message": {
                                "type": "string"
                            },
                            "type": {
                                "type": "string"
                            },
                            "details": {
                                "type": "object"
                            }
                        }
                    }
                }
            }
        }
    }
}