{"id":15040,"date":"2024-05-11T15:42:22","date_gmt":"2024-05-11T07:42:22","guid":{"rendered":"https:\/\/www.aisharenet.com\/?p=15040"},"modified":"2025-01-07T17:45:49","modified_gmt":"2025-01-07T09:45:49","slug":"difyzidingyigongjuai","status":"publish","type":"post","link":"https:\/\/www.kdjingpai.com\/en\/difyzidingyigongjuai\/","title":{"rendered":"Dify\u81ea\u5b9a\u4e49\u5de5\u5177\u4f8b\u5b50"},"content":{"rendered":"

1.\u5929\u6c14\uff08JSON\uff09<\/h2>\n
{\r\n\"openapi\": \"3.1.0\",\r\n\"info\": {\r\n\"title\": \"Get weather data\",\r\n\"description\": \"Retrieves current weather data for a location.\",\r\n\"version\": \"v1.0.0\"\r\n},\r\n\"servers\": [\r\n{\r\n\"url\": \"https:\/\/weather.example.com\"\r\n}\r\n],\r\n\"paths\": {\r\n\"\/location\": {\r\n\"get\": {\r\n\"description\": \"Get temperature for a specific location\",\r\n\"operationId\": \"GetCurrentWeather\",\r\n\"parameters\": [\r\n{\r\n\"name\": \"location\",\r\n\"in\": \"query\",\r\n\"description\": \"The city and state to retrieve the weather for\",\r\n\"required\": true,\r\n\"schema\": {\r\n\"type\": \"string\"\r\n}\r\n}\r\n],\r\n\"deprecated\": false\r\n}\r\n}\r\n},\r\n\"components\": {\r\n\"schemas\": {}\r\n}\r\n}\r\n<\/code><\/pre>\n
\u8fd9\u6bb5\u4ee3\u7801\u662f\u4e00\u4e2aOpenAPI\u89c4\u8303\u7684JSON\u6587\u4ef6\uff0c\u7528\u4e8e\u63cf\u8ff0\u4e00\u4e2a\u83b7\u53d6\u5929\u6c14\u6570\u636e\u7684API\u3002\u603b\u7684\u6765\u8bf4\uff0c\u8fd9\u4e2aAPI\u5141\u8bb8\u7528\u6237\u67e5\u8be2\u7279\u5b9a\u4f4d\u7f6e\u7684\u5929\u6c14\u6570\u636e\u3002<\/p>\n
    \n
  • \"openapi\": \"3.1.0\"<\/code>\uff1a\u8fd9\u8868\u793a\u4f7f\u7528\u7684OpenAPI\u89c4\u8303\u7684\u7248\u672c\u662f3.1.0\u3002<\/li>\n
  • \"info\"<\/code>\uff1a\u8fd9\u90e8\u5206\u63d0\u4f9b\u4e86API\u7684\u57fa\u672c\u4fe1\u606f\uff0c\u5305\u62ec\u6807\u9898\u3001\u63cf\u8ff0\u548c\u7248\u672c\u3002<\/li>\n
  • \"servers\"<\/code>\uff1a\u8fd9\u90e8\u5206\u5217\u51fa\u4e86API\u7684\u670d\u52a1\u5668URL\u3002<\/li>\n
  • \"paths\"<\/code>\uff1a\u8fd9\u90e8\u5206\u5b9a\u4e49\u4e86API\u7684\u8def\u5f84\u548c\u64cd\u4f5c\u3002\u5728\u8fd9\u4e2a\u4f8b\u5b50\u4e2d\uff0c\u6709\u4e00\u4e2aGET\u64cd\u4f5c\uff0c\u8def\u5f84\u662f\/location<\/code>\uff0c\u7528\u4e8e\u83b7\u53d6\u7279\u5b9a\u4f4d\u7f6e\u7684\u5929\u6c14\u3002\u8fd9\u4e2a\u64cd\u4f5c\u9700\u8981\u4e00\u4e2a\u540d\u4e3alocation<\/code>\u7684\u67e5\u8be2\u53c2\u6570\uff0c\u8fd9\u4e2a\u53c2\u6570\u662f\u5fc5\u9700\u7684\uff0c\u7c7b\u578b\u662f\u5b57\u7b26\u4e32\u3002<\/li>\n
  • \"components\"<\/code>\uff1a\u8fd9\u90e8\u5206\u7528\u4e8e\u5b9a\u4e49API\u4e2d\u4f7f\u7528\u7684\u6a21\u5f0f\uff0c\u4f46\u5728\u8fd9\u4e2a\u4f8b\u5b50\u4e2d\uff0c\u5b83\u662f\u7a7a\u7684\u3002<\/li>\n<\/ul>\n
    \u5728OpenAPI\u89c4\u8303\u4e2d\uff0cparameters<\/code>\u662f\u4e00\u4e2a\u6570\u7ec4\uff0c\u7528\u4e8e\u5b9a\u4e49API\u64cd\u4f5c\u7684\u8f93\u5165\u53c2\u6570\u3002parameters<\/code>\u5b9a\u4e49\u4e86\u4e00\u4e2a\u540d\u4e3alocation<\/code>\u7684\u67e5\u8be2\u53c2\u6570\uff0c\u8fd9\u4e2a\u53c2\u6570\u662f\u5fc5\u9700\u7684\uff0c\u7c7b\u578b\u662f\u5b57\u7b26\u4e32\u3002\u6bcf\u4e2a\u53c2\u6570\u90fd\u662f\u4e00\u4e2a\u5bf9\u8c61\uff0c\u5305\u542b\u4ee5\u4e0b\u5c5e\u6027\uff1a<\/p>\n
      \n
    • \"name\"<\/code>\uff1a\u53c2\u6570\u7684\u540d\u79f0\u3002<\/li>\n
    • \"in\"<\/code>\uff1a\u53c2\u6570\u7684\u4f4d\u7f6e\u3002\u53ef\u4ee5\u662f\"query\"<\/code>,\u00a0\"header\"<\/code>,\u00a0\"path\"<\/code>\u6216\"cookie\"<\/code>\u3002<\/li>\n
    • \"description\"<\/code>\uff1a\u53c2\u6570\u7684\u63cf\u8ff0\u3002<\/li>\n
    • \"required\"<\/code>\uff1a\u5982\u679c\u4e3atrue<\/code>\uff0c\u5219\u6b64\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002<\/li>\n
    • \"schema\"<\/code>\uff1a\u53c2\u6570\u7684\u6570\u636e\u7c7b\u578b\u3002<\/li>\n<\/ul>\n
      \u91cd\u70b9\u4ecb\u7ecd\u4e0b\u53c2\u6570\u7684\u4f4d\u7f6e\uff0c4\u79cd\u60c5\u51b5\u5982\u4e0b\u6240\u793a\uff1a<\/p>\n
        \n
      • header\u53c2\u6570\uff0c\u7528\u4e8e\u5728\u8bf7\u6c42\u5934\u4e2d\u4f20\u9012API\u5bc6\u94a5\u3002<\/li>\n
      • path\u53c2\u6570\uff0c\u7528\u4e8e\u5728URL\u8def\u5f84\u4e2d\u6307\u5b9a\u8981\u68c0\u7d22\u7684\u5bf9\u8c61\u7684ID\u3002<\/li>\n
      • cookie\u53c2\u6570\uff0c\u7528\u4e8e\u5728cookie\u4e2d\u4f20\u9012\u7528\u6237\u7684\u4f1a\u8bddID\u3002<\/li>\n
      • query\u53c2\u6570\uff0c\u9644\u52a0\u5728URL\u540e\u9762\u7684\u53c2\u6570\uff0c\u901a\u5e38\u7528\u4e8e\u63d0\u4f9b\u4fe1\u606f\u8fc7\u6ee4\u3002<\/li>\n<\/ul>\n
        \u521b\u5efa\u81ea\u5b9a\u4e49\u5de5\u5177\u754c\u9762\uff1a<\/p>\n
        \"Dify\u81ea\u5b9a\u4e49\u5de5\u5177\u4f8b\u5b50-1\"<\/p>\n
        \u6d4b\u8bd5\u5de5\u5177\u63a5\u53e3\u754c\u9762\uff1a<\/p>\n
        \"Dify\u81ea\u5b9a\u4e49\u5de5\u5177\u4f8b\u5b50-2\"<\/p>\n
         <\/p>\n
        2.\u5ba0\u7269\u5546\u5e97\uff08YAML\uff09<\/h2>\n
        # Taken from https:\/\/github.com\/OAI\/OpenAPI-Specification\/blob\/main\/examples\/v3.0\/petstore.yaml\r\nopenapi: \"3.0.0\"\r\ninfo:\r\nversion: 1.0.0\r\ntitle: Swagger Petstore\r\nlicense:\r\nname: MIT\r\nservers:\r\n- url: https:\/\/petstore.swagger.io\/v1\r\npaths:\r\n\/pets:\r\nget:\r\nsummary: List all pets\r\noperationId: listPets\r\ntags:\r\n- pets\r\nparameters:\r\n- name: limit\r\nin: query\r\ndescription: How many items to return at one time (max 100)\r\nrequired: false\r\nschema:\r\ntype: integer\r\nmaximum: 100\r\nformat: int32\r\nresponses:\r\n'200':\r\ndescription: A paged array of pets\r\nheaders:\r\nx-next:\r\ndescription: A link to the next page of responses\r\nschema:\r\ntype: string\r\ncontent:\r\napplication\/json:    \r\nschema:\r\n$ref: \"#\/components\/schemas\/Pets\"\r\ndefault:\r\ndescription: unexpected error\r\ncontent:\r\napplication\/json:\r\nschema:\r\n$ref: \"#\/components\/schemas\/Error\"\r\npost:\r\nsummary: Create a pet\r\noperationId: createPets\r\ntags:\r\n- pets\r\nresponses:\r\n'201':\r\ndescription: Null response\r\ndefault:\r\ndescription: unexpected error\r\ncontent:\r\napplication\/json:\r\nschema:\r\n$ref: \"#\/components\/schemas\/Error\"\r\n\/pets\/{petId}:\r\nget:\r\nsummary: Info for a specific pet\r\noperationId: showPetById\r\ntags:\r\n- pets\r\nparameters:\r\n- name: petId\r\nin: path\r\nrequired: true\r\ndescription: The id of the pet to retrieve\r\nschema:\r\ntype: string\r\nresponses:\r\n'200':\r\ndescription: Expected response to a valid request\r\ncontent:\r\napplication\/json:\r\nschema:\r\n$ref: \"#\/components\/schemas\/Pet\"\r\ndefault:\r\ndescription: unexpected error\r\ncontent:\r\napplication\/json:\r\nschema:\r\n$ref: \"#\/components\/schemas\/Error\"\r\ncomponents:\r\nschemas:\r\nPet:\r\ntype: object\r\nrequired:\r\n- id\r\n- name\r\nproperties:\r\nid:\r\ntype: integer\r\nformat: int64\r\nname:\r\ntype: string\r\ntag:\r\ntype: string\r\nPets:\r\ntype: array\r\nmaxItems: 100\r\nitems:\r\n$ref: \"#\/components\/schemas\/Pet\"\r\nError:\r\ntype: object\r\nrequired:\r\n- code\r\n- message\r\nproperties:\r\ncode:\r\ntype: integer\r\nformat: int32\r\nmessage:\r\ntype: string\r\n<\/code><\/pre>\n
        pet.yaml<\/code>\u00a0\u662f\u4e00\u4e2a OpenAPI \u89c4\u8303\u6587\u4ef6\uff0c\u7528\u4e8e\u63cf\u8ff0\u548c\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3a “Swagger Petstore” \u7684 API \u7684\u63a5\u53e3\u3002\u8fd9\u4e2a\u6587\u4ef6\u4f7f\u7528\u4e86 YAML \u683c\u5f0f\uff0c\u5b83\u662f\u4e00\u79cd\u7528\u4e8e\u7f16\u5199\u914d\u7f6e\u6587\u4ef6\u7684\u4eba\u7c7b\u53ef\u8bfb\u7684\u6570\u636e\u5e8f\u5217\u5316\u6807\u51c6\u3002\u8fd9\u4e2a\u6587\u4ef6\u4e3a\u5f00\u53d1\u8005\u63d0\u4f9b\u4e86\u4e00\u4e2a\u6e05\u6670\u7684 API \u63a5\u53e3\u5b9a\u4e49\uff0c\u4f7f\u5f97\u5f00\u53d1\u8005\u53ef\u4ee5\u77e5\u9053\u5982\u4f55\u4e0e “Swagger Petstore” API \u8fdb\u884c\u4ea4\u4e92\u3002\u6587\u4ef6\u4e2d\u7684\u4e3b\u8981\u90e8\u5206\u5305\u62ec\uff1a<\/p>\n