René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Automatically negotiate API version to use","articleBody":"The [go client has an option to automatically negotiate what API version should be selected](https://github.com/moby/moby/blob/6e52828ec38b2f53f695b97ffb0b4ba94fa255e4/client/client.go#L312-L351).\n\nThis could also be used here.\n\n\u003cdetails\u003e\u003csummary\u003eFork example calling `/version` returns the following:\u003c/summary\u003e\n\n```\n{\n  \"Platform\" : {\n    \"Name\" : \"Docker Desktop 4.51.0 (210443)\"\n  },\n  \"Components\" : [ {\n    \"Name\" : \"Engine\",\n    \"Version\" : \"28.5.2\",\n    \"Details\" : {\n      \"ApiVersion\" : \"1.51\",\n      \"Arch\" : \"amd64\",\n      \"BuildTime\" : \"2025-11-05T14:43:25.000000000+00:00\",\n      \"Experimental\" : \"false\",\n      \"GitCommit\" : \"89c5e8f\",\n      \"GoVersion\" : \"go1.25.3\",\n      \"KernelVersion\" : \"6.6.87.2-microsoft-standard-WSL2\",\n      \"MinAPIVersion\" : \"1.24\",\n      \"Os\" : \"linux\"\n    }\n  }, {\n    \"Name\" : \"containerd\",\n    \"Version\" : \"v1.7.29\",\n    \"Details\" : {\n      \"GitCommit\" : \"442cb34bda9a6a0fed82a2ca7cade05c5c749582\"\n    }\n  }, {\n    \"Name\" : \"runc\",\n    \"Version\" : \"1.3.3\",\n    \"Details\" : {\n      \"GitCommit\" : \"v1.3.3-0-gd842d771\"\n    }\n  }, {\n    \"Name\" : \"docker-init\",\n    \"Version\" : \"0.19.0\",\n    \"Details\" : {\n      \"GitCommit\" : \"de40ad0\"\n    }\n  } ],\n  \"Version\" : \"28.5.2\",\n  \"ApiVersion\" : \"1.51\",\n  \"MinAPIVersion\" : \"1.24\",\n  \"GitCommit\" : \"89c5e8f\",\n  \"GoVersion\" : \"go1.25.3\",\n  \"Os\" : \"linux\",\n  \"Arch\" : \"amd64\",\n  \"KernelVersion\" : \"6.6.87.2-microsoft-standard-WSL2\",\n  \"BuildTime\" : \"2025-11-05T14:43:25.000000000+00:00\"\n}\n```\n\n```\n{\n  \"Platform\" : {\n    \"Name\" : \"Docker Desktop 4.52.0 (210994)\"\n  },\n  \"Components\" : [ {\n    \"Name\" : \"Engine\",\n    \"Version\" : \"29.0.1\",\n    \"Details\" : {\n      \"ApiVersion\" : \"1.52\",\n      \"Arch\" : \"amd64\",\n      \"BuildTime\" : \"2025-11-14T16:17:57.000000000+00:00\",\n      \"Experimental\" : \"false\",\n      \"GitCommit\" : \"198b5e3\",\n      \"GoVersion\" : \"go1.25.4\",\n      \"KernelVersion\" : \"6.6.87.2-microsoft-standard-WSL2\",\n      \"MinAPIVersion\" : \"1.44\",\n      \"Os\" : \"linux\"\n    }\n  }, {\n    \"Name\" : \"containerd\",\n    \"Version\" : \"v2.1.5\",\n    \"Details\" : {\n      \"GitCommit\" : \"fcd43222d6b07379a4be9786bda52438f0dd16a1\"\n    }\n  }, {\n    \"Name\" : \"runc\",\n    \"Version\" : \"1.3.3\",\n    \"Details\" : {\n      \"GitCommit\" : \"v1.3.3-0-gd842d771\"\n    }\n  }, {\n    \"Name\" : \"docker-init\",\n    \"Version\" : \"0.19.0\",\n    \"Details\" : {\n      \"GitCommit\" : \"de40ad0\"\n    }\n  } ],\n  \"Version\" : \"29.0.1\",\n  \"ApiVersion\" : \"1.52\",\n  \"MinAPIVersion\" : \"1.44\",\n  \"GitCommit\" : \"198b5e3\",\n  \"GoVersion\" : \"go1.25.4\",\n  \"Os\" : \"linux\",\n  \"Arch\" : \"amd64\",\n  \"KernelVersion\" : \"6.6.87.2-microsoft-standard-WSL2\",\n  \"BuildTime\" : \"2025-11-14T16:17:57.000000000+00:00\"\n}\n```\n\u003c/details\u003e\n\nThe `MinAPIVersion` attribute could be used to compare it with the client's version.\nIf `ClientAPIVersion` \u003c `MinAPIVersion` the client could log an warning and force the use of `MinAPIVersion` - this should prevent hard errors at the cost that the API might be incompatible and not work 100%.\n\nThe same can also be done the other way around if `ClientAPIVersion` \u003e `ApiVersion`.\n\nNOTE: It's currently possible to just omit the ``/\u003cversion\u003e`` prefix from the paths.\nHowever [using the API without a version-prefix is deprecated and will be removed in a future release](https://docs.docker.com/reference/api/engine/version/v1.52/#section/Versioning).","author":{"url":"https://github.com/AB-xdev","@type":"Person","name":"AB-xdev"},"datePublished":"2025-11-24T09:17:29.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/2547/docker-java/issues/2547"}