{"id":19055,"date":"2023-04-23T07:06:21","date_gmt":"2023-04-23T03:36:21","guid":{"rendered":"https:\/\/nabfollower.com\/blog\/how-to-resolve-server-urls-containing-variables-in-openapi-3x-definitions-kaj\/"},"modified":"2023-04-23T07:06:21","modified_gmt":"2023-04-23T03:36:21","slug":"how-to-resolve-server-urls-containing-variables-in-openapi-3x-definitions-kaj","status":"publish","type":"post","link":"https:\/\/nabfollower.com\/blog\/how-to-resolve-server-urls-containing-variables-in-openapi-3x-definitions-kaj\/","title":{"rendered":"\u0686\u06af\u0648\u0646\u0647 URL \u0647\u0627\u06cc \u0633\u0631\u0648\u0631 \u062d\u0627\u0648\u06cc \u0645\u062a\u063a\u06cc\u0631\u0647\u0627 \u0631\u0627 \u062f\u0631 \u062a\u0639\u0627\u0631\u06cc\u0641 OpenAPI 3.x \u062d\u0644 \u06a9\u0646\u06cc\u0645\u061f"},"content":{"rendered":"
\n

\u0645\u0634\u062e\u0635\u0627\u062a OpenAPI \u0628\u0647 \u0637\u0648\u0631 \u06af\u0633\u062a\u0631\u062f\u0647 \u0628\u0631\u0627\u06cc \u062a\u0639\u0631\u06cc\u0641 API \u0647\u0627\u06cc RESTful \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0645\u06cc \u0634\u0648\u062f. \u06cc\u06a9\u06cc \u0627\u0632 \u0627\u062c\u0632\u0627\u06cc \u062d\u06cc\u0627\u062a\u06cc \u0645\u0634\u062e\u0635\u0627\u062a OpenAPI\u060c \u0628\u062e\u0634 \u0633\u0631\u0648\u0631 \u0627\u0633\u062a \u06a9\u0647 \u0644\u06cc\u0633\u062a\u06cc \u0627\u0632 URL \u0647\u0627\u06cc\u06cc \u0631\u0627 \u06a9\u0647 \u0645\u06cc \u062a\u0648\u0627\u0646 \u0628\u0647 API \u062f\u0633\u062a\u0631\u0633\u06cc \u062f\u0627\u0634\u062a\u060c \u0627\u0631\u0627\u0626\u0647 \u0645\u06cc \u062f\u0647\u062f. \u0628\u0627 \u0627\u06cc\u0646 \u062d\u0627\u0644\u060c \u06a9\u0627\u0631 \u0628\u0627 \u0628\u062e\u0634 \u0633\u0631\u0648\u0631 \u0645\u06cc \u062a\u0648\u0627\u0646\u062f \u067e\u06cc\u0686\u06cc\u062f\u0647 \u0628\u0627\u0634\u062f\u060c \u0628\u0647 \u062e\u0635\u0648\u0635 \u0632\u0645\u0627\u0646\u06cc \u06a9\u0647 URL \u0647\u0627\u06cc \u0633\u0631\u0648\u0631 \u062d\u0627\u0648\u06cc \u0645\u062a\u063a\u06cc\u0631\u0647\u0627 \u0648 \u0633\u0627\u06cc\u0631 \u0627\u062c\u0632\u0627\u06cc \u067e\u0648\u06cc\u0627 \u0647\u0633\u062a\u0646\u062f. \u0622\u0646\u062c\u0627\u0633\u062a openapi-url-resolver<\/strong> \u062c\u0644\u0648 \u0645\u06cc \u0622\u06cc\u062f.<\/p>\n

\u062f\u0631 \u0632\u06cc\u0631 \u06cc\u06a9 \u0645\u062b\u0627\u0644 \u0634\u06cc \u0633\u0631\u0648\u0631 \u0622\u0648\u0631\u062f\u0647 \u0634\u062f\u0647 \u0627\u0633\u062a\u060c<\/p>\n

\n
{<\/span>\n  \"<\/span>servers<\/span>\"<\/span>:<\/span> [<\/span>\n    {<\/span>\n      \"<\/span>url<\/span>\"<\/span>:<\/span> \"<\/span>https:\/\/{username}.gigantic-server.com:{port}\/{basePath}<\/span>\"<\/span>,<\/span>\n      \"<\/span>description<\/span>\"<\/span>:<\/span> \"<\/span>The production API server<\/span>\"<\/span>,<\/span>\n      \"<\/span>variables<\/span>\"<\/span>:<\/span> {<\/span>\n        \"<\/span>username<\/span>\"<\/span>:<\/span> {<\/span>\n          \"<\/span>default<\/span>\"<\/span>:<\/span> \"<\/span>demo<\/span>\"<\/span>,<\/span>\n          \"<\/span>description<\/span>\"<\/span>:<\/span> \"<\/span>this value is assigned by the service provider, in this example `gigantic-server.com`<\/span>\"<\/span>\n        },<\/span>\n        \"<\/span>port<\/span>\"<\/span>:<\/span> {<\/span>\n          \"<\/span>enum<\/span>\"<\/span>:<\/span> [<\/span>\n            \"<\/span>8443<\/span>\"<\/span>,<\/span>\n            \"<\/span>443<\/span>\"<\/span>\n          ],<\/span>\n          \"<\/span>default<\/span>\"<\/span>:<\/span> \"<\/span>8443<\/span>\"<\/span>\n        },<\/span>\n        \"<\/span>basePath<\/span>\"<\/span>:<\/span> {<\/span>\n          \"<\/span>default<\/span>\"<\/span>:<\/span> \"<\/span>v2<\/span>\"<\/span>\n        }<\/span>\n      }<\/span>\n    }<\/span>\n  ]<\/span>\n}<\/span>\n<\/code><\/pre>\n
\n
\n    \u0648\u0627\u0631\u062f \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u0634\u0648\u06cc\u062f<\/title>\n    \n<\/svg><\/p>\n
    \u0627\u0632 \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u062e\u0627\u0631\u062c \u0634\u0648\u06cc\u062f<\/title>\n    \n<\/svg><\/p>\n<\/div>\n<\/div>\n<\/div>\n
\n
  URL \u0647\u0627 \u06cc\u0627 \u0645\u06cc\u0632\u0628\u0627\u0646 \u0647\u0627\u06cc \u0633\u0631\u0648\u0631 \u0631\u0627 \u0627\u0632 \u062a\u0639\u0627\u0631\u06cc\u0641 OpenAPI 3.x \u062d\u0644 \u06a9\u0646\u06cc\u062f
\n<\/h2>\n
openapi-url-resolver<\/strong> \u06cc\u06a9 \u0628\u0633\u062a\u0647 NPM \u0633\u0628\u06a9 \u0648\u0632\u0646 \u0627\u0633\u062a \u06a9\u0647 \u0641\u0631\u0622\u06cc\u0646\u062f \u062d\u0644 \u0648 \u0641\u0635\u0644 URL \u0647\u0627\u06cc \u0633\u0631\u0648\u0631 \u0631\u0627 \u0627\u0632 \u0645\u0634\u062e\u0635\u0627\u062a OpenAPI \u0633\u0627\u062f\u0647 \u0645\u06cc \u06a9\u0646\u062f.  \u0628\u0627 openapi-url-resolver<\/code>\u060c \u0645\u06cc \u062a\u0648\u0627\u0646\u06cc\u062f \u0628\u0647 \u0631\u0627\u062d\u062a\u06cc \u0627\u0637\u0644\u0627\u0639\u0627\u062a \u0633\u0631\u0648\u0631 \u0631\u0627 \u0627\u0633\u062a\u062e\u0631\u0627\u062c \u06a9\u0646\u06cc\u062f \u0648 \u067e\u0631\u0648\u062a\u06a9\u0644 \u0647\u0627 \u0631\u0627 \u0627\u0632 URL \u0647\u0627\u06cc \u062d\u0644 \u0634\u062f\u0647 \u062d\u0630\u0641 \u06a9\u0646\u06cc\u062f \u0648 \u06a9\u0627\u0631 \u0628\u0627 API \u0647\u0627\u06cc\u06cc \u0631\u0627 \u06a9\u0647 \u0628\u0627 \u0645\u0634\u062e\u0635\u0627\u062a OpenAPI \u0645\u0637\u0627\u0628\u0642\u062a \u062f\u0627\u0631\u0646\u062f \u0622\u0633\u0627\u0646 \u062a\u0631 \u0645\u06cc \u06a9\u0646\u062f.<\/p>\n
<\/p>\n
\u062f\u0631 \u0627\u06cc\u0646\u062c\u0627 \u0628\u0631\u062e\u06cc \u0627\u0632 \u0648\u06cc\u0698\u06af\u06cc \u0647\u0627\u06cc \u06a9\u0644\u06cc\u062f\u06cc openapi-url-resolver \u0622\u0648\u0631\u062f\u0647 \u0634\u062f\u0647 \u0627\u0633\u062a:<\/p>\n
    \n
  • \ud83d\udce6 \u0633\u0628\u06a9 \u0648\u0632\u0646<\/strong> \u0645\u0627\u0698\u0648\u0644 \u0628\u0627 \u0627\u0646\u062f\u0627\u0632\u0647 \u062a\u0646\u0647\u0627 965 \u0628\u0627\u06cc\u062a<\/li>\n
  • \ud83d\ude80 \u0648\u0627\u0628\u0633\u062a\u06af\u06cc \u0635\u0641\u0631<\/strong>\u060c \u0646\u0635\u0628 \u0648 \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 \u0622\u0646 \u0631\u0627 \u062f\u0631 \u067e\u0631\u0648\u0698\u0647 \u0647\u0627\u06cc \u062e\u0648\u062f \u0622\u0633\u0627\u0646 \u0645\u06cc \u06a9\u0646\u062f<\/li>\n
  • \ud83c\udfaf \u0631\u0627\u0647 \u06a9\u0627\u0631\u0622\u0645\u062f \u0648 \u0633\u0627\u062f\u0647 \u0628\u0631\u0627\u06cc \u062d\u0644 \u06a9\u0631\u062f\u0646 URL \u0647\u0627 \u0627\u0632 \u0645\u0634\u062e\u0635\u0627\u062a OpenAPI<\/li>\n<\/ul>\n
    \u0645\u06cc \u062a\u0648\u0627\u0646\u06cc\u062f \u0646\u0635\u0628 \u06a9\u0646\u06cc\u062f openapi-url-resolver<\/code> \u0627\u0632 \u0637\u0631\u06cc\u0642 NPM:<\/p>\n
    \n
    npm install <\/span>openapi-url-resolver\n<\/code><\/pre>\n
    \n
    \n    \u0648\u0627\u0631\u062f \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u0634\u0648\u06cc\u062f<\/title>\n    \n<\/svg><\/p>\n
        \u0627\u0632 \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u062e\u0627\u0631\u062c \u0634\u0648\u06cc\u062f<\/title>\n    \n<\/svg><\/p>\n<\/div>\n<\/div>\n<\/div>\n
    \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 openapi-url-resolver \u0633\u0627\u062f\u0647 \u0627\u0633\u062a.  \u062a\u0646\u0647\u0627 \u06a9\u0627\u0631\u06cc \u06a9\u0647 \u0628\u0627\u06cc\u062f \u0627\u0646\u062c\u0627\u0645 \u062f\u0647\u06cc\u062f \u0627\u06cc\u0646 \u0627\u0633\u062a \u06a9\u0647 \u06cc\u06a9 \u0634\u06cc\u0621 \u0645\u0634\u062e\u0635\u0627\u062a OpenAPI 3.x \u0631\u0627 \u0628\u0647 \u0622\u0646 \u0627\u0631\u0633\u0627\u0644 \u06a9\u0646\u06cc\u062f resolve()<\/code> \u062a\u0627\u0628\u0639\u060c \u0648 \u0622\u0631\u0627\u06cc\u0647 \u0627\u06cc \u0627\u0632 URL \u0647\u0627\u06cc \u0633\u0631\u0648\u0631 \u062d\u0644 \u0634\u062f\u0647 \u0631\u0627 \u0628\u0631\u0645\u06cc \u06af\u0631\u062f\u0627\u0646\u062f.  \u0647\u0645\u0686\u0646\u06cc\u0646 \u0645\u06cc \u062a\u0648\u0627\u0646\u06cc\u062f \u067e\u0627\u0631\u0627\u0645\u062a\u0631 \u062f\u0648\u0645 \u0631\u0627 \u0628\u0647 \u0622\u0646 \u0627\u0631\u0633\u0627\u0644 \u06a9\u0646\u06cc\u062f resolve()<\/code> \u0639\u0645\u0644\u06a9\u0631\u062f \u062f\u0631\u06cc\u0627\u0641\u062a URL \u0647\u0627\u06cc \u0633\u0631\u0648\u0631 \u0628\u0627 \u067e\u0631\u0648\u062a\u06a9\u0644 \u0647\u0627.<\/p>\n
    \u062f\u0631 \u0627\u06cc\u0646\u062c\u0627 \u0645\u062b\u0627\u0644\u06cc \u0627\u0632 \u0646\u062d\u0648\u0647 \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 openapi-url-resolver \u0622\u0648\u0631\u062f\u0647 \u0634\u062f\u0647 \u0627\u0633\u062a:<\/p>\n
    \u0627\u06cc\u0646 \u06cc\u06a9 \u0627\u0628\u0632\u0627\u0631 \u0639\u0627\u0644\u06cc \u0628\u0631\u0627\u06cc \u062a\u0648\u0633\u0639\u0647 \u062f\u0647\u0646\u062f\u06af\u0627\u0646\u06cc \u0627\u0633\u062a \u06a9\u0647 \u0646\u06cc\u0627\u0632 \u0628\u0647 \u0627\u0633\u062a\u062e\u0631\u0627\u062c \u0627\u0637\u0644\u0627\u0639\u0627\u062a \u0633\u0631\u0648\u0631 \u0627\u0632 \u0645\u0634\u062e\u0635\u0627\u062a OpenAPI \u062f\u0627\u0631\u0646\u062f. \u0627\u06cc\u0646 \u0633\u0628\u06a9 \u0648\u0632\u0646 \u0627\u0633\u062a\u060c \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 \u0622\u0646 \u0622\u0633\u0627\u0646 \u0627\u0633\u062a \u0648 \u0647\u06cc\u0686 \u06af\u0648\u0646\u0647 \u0648\u0627\u0628\u0633\u062a\u06af\u06cc \u0646\u062f\u0627\u0631\u062f\u060c \u0648 \u0622\u0646 \u0631\u0627 \u0628\u0647 \u06cc\u06a9 \u0645\u06a9\u0645\u0644 \u0639\u0627\u0644\u06cc \u0628\u0631\u0627\u06cc \u0647\u0631 \u067e\u0631\u0648\u0698\u0647 \u0627\u06cc \u06a9\u0647 \u0627\u0632 OpenAPI \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0645\u06cc \u06a9\u0646\u062f \u062a\u0628\u062f\u06cc\u0644 \u0645\u06cc \u06a9\u0646\u062f.<\/strong>.<\/p>\n
    \u0627\u06af\u0631 \u0639\u0644\u0627\u0642\u0647 \u0645\u0646\u062f \u0628\u0647 \u06a9\u0633\u0628 \u0627\u0637\u0644\u0627\u0639\u0627\u062a \u0628\u06cc\u0634\u062a\u0631 \u062f\u0631 \u0645\u0648\u0631\u062f openapi-url-resolver<\/strong>\u060c \u0645\u062e\u0632\u0646 GitHub \u0631\u0627 \u0628\u0631\u0631\u0633\u06cc \u06a9\u0646\u06cc\u062f \u0648 \u0622\u0646 \u0631\u0627 \u062f\u0631 \u067e\u0631\u0648\u0698\u0647 \u0647\u0627\u06cc \u062e\u0648\u062f \u0627\u0645\u062a\u062d\u0627\u0646 \u06a9\u0646\u06cc\u062f!<\/p>\n
    \u0645\u062a\u0634\u06a9\u0631\u0645.<\/p>\n<\/p><\/div>\n","protected":false},"excerpt":{"rendered":"
    \u0645\u0634\u062e\u0635\u0627\u062a OpenAPI \u0628\u0647 \u0637\u0648\u0631 \u06af\u0633\u062a\u0631\u062f\u0647 \u0628\u0631\u0627\u06cc \u062a\u0639\u0631\u06cc\u0641 API \u0647\u0627\u06cc RESTful \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0645\u06cc \u0634\u0648\u062f. \u06cc\u06a9\u06cc \u0627\u0632 \u0627\u062c\u0632\u0627\u06cc \u062d\u06cc\u0627\u062a\u06cc \u0645\u0634\u062e\u0635\u0627\u062a OpenAPI\u060c \u0628\u062e\u0634 \u0633\u0631\u0648\u0631 \u0627\u0633\u062a \u06a9\u0647 \u0644\u06cc\u0633\u062a\u06cc \u0627\u0632 URL \u0647\u0627\u06cc\u06cc \u0631\u0627 \u06a9\u0647 \u0645\u06cc \u062a\u0648\u0627\u0646 \u0628\u0647 API \u062f\u0633\u062a\u0631\u0633\u06cc \u062f\u0627\u0634\u062a\u060c \u0627\u0631\u0627\u0626\u0647 \u0645\u06cc \u062f\u0647\u062f. \u0628\u0627 \u0627\u06cc\u0646 \u062d\u0627\u0644\u060c \u06a9\u0627\u0631 \u0628\u0627 \u0628\u062e\u0634 \u0633\u0631\u0648\u0631 \u0645\u06cc \u062a\u0648\u0627\u0646\u062f \u067e\u06cc\u0686\u06cc\u062f\u0647 \u0628\u0627\u0634\u062f\u060c \u0628\u0647 \u062e\u0635\u0648\u0635 \u0632\u0645\u0627\u0646\u06cc \u06a9\u0647 URL \u0647\u0627\u06cc …<\/p>\n","protected":false},"author":2,"featured_media":19056,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"fifu_image_url":"","fifu_image_alt":"","footnotes":""},"categories":[339],"tags":[],"class_list":["post-19055","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dev"],"_links":{"self":[{"href":"https:\/\/nabfollower.com\/blog\/wp-json\/wp\/v2\/posts\/19055","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nabfollower.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/nabfollower.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/nabfollower.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/nabfollower.com\/blog\/wp-json\/wp\/v2\/comments?post=19055"}],"version-history":[{"count":0,"href":"https:\/\/nabfollower.com\/blog\/wp-json\/wp\/v2\/posts\/19055\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/nabfollower.com\/blog\/wp-json\/wp\/v2\/media\/19056"}],"wp:attachment":[{"href":"https:\/\/nabfollower.com\/blog\/wp-json\/wp\/v2\/media?parent=19055"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nabfollower.com\/blog\/wp-json\/wp\/v2\/categories?post=19055"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nabfollower.com\/blog\/wp-json\/wp\/v2\/tags?post=19055"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}