187      財經資訊

查詢API服務文檔__API管理相關接口_API_API 網關-阿裏雲

描述

查詢指定API的服務說明文檔。

• 此功能麵向調用API的用戶，指定的API必須是發布到運行環境，且Visibility=PUBLIC的API或者被授權的Visibility=PRIVATE的API
• 若您是調用API的用戶，該接口返回您指定的API的服務信息及參數定義等詳情信息。
• 若您是開放API的用戶，那麼調用該接口可以查看當前指定API在指定環境中運行的定義，可能與您現在修改中的API定義不同，是真正在環境中生效的定義。
• 若您是開放API的用戶，由於該接口麵向API調用者鑒權，所以您需要確認該API為PUBLIC類型或者您的相關APP已被授權。

請求參數

返回參數

示例

請求示例

https://apigateway.cn-qingdao.aliyuncs.com/?Action=DescribeApiDoc
&GroupId=0009db9c828549768a200320714b8930
&ApiId=3b81fd160f5645e097cc8855d75a1cf6    
&<公共請求參數>

返回示例

XML格式

<DescribeApiDocResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BZ014</RequestId>
    <RegionId>cn-qingdao</RegionId>
    <GroupId>0009db9c828549768a200320714b8930</GroupId>
    <GroupName>myGroup2</GroupName>
    <StageName>RELEASE</StageName>
    <ApiId>3b81fd160f5645e097cc8855d75a1cf6</ApiId>
    <ApiName>creatobject</ApiName>
    <Description>對象創建</Description>
    <Visibility>public</Visibility>
    <AuthType>APP</AuthType>
    <ResultType>application/json</ResultType>
    <ResultSample></ResultSample>
    <FailResultSample></FailResultSample>
    <ErrorCodeSamples>
        <ErrorCodeSample>
            <Code>400</Code>
            <Message>Missing the parameter UserId</Message>
            <Description>請求缺少參數 UserId</Description>
        </ErrorCodeSample>
    </ErrorCodeSamples>
    <RequestConfig>
        <RequestProtocol>HTTP</RequestProtocol>
        <RequestHttpMethod>GET</RequestHttpMethod>
        <RequestPath>/mypath/creatobject</RequestPath>
        <BodyFormat>FORM</BodyFormat>
        <PostBodyDescription>對象</PostBodyDescription>
    </RequestConfig>        
    <RequestParameters>
        <RequestParameter>
            <ApiParameterName>RequestKey1</ApiParameterName>
            <Location>QUERY</Location>
            <ParameterType>String</ParameterType>
            <Required>REQUIRED</Required>
            <DefaultValue></DefaultValue>
            <DemoValue>demo1</DemoValue>
            <MaxValue></MaxValue>
            <MinValue></MinValue>
            <MaxLength>100</MaxLength>
            <MinLength>3</MinLength>
            <RegularExpression></RegularExpression>
            <JsonScheme></JsonScheme>
            <EnumValue></EnumValue>
            <DocShow>PUBLIC</DocShow>
            <DocOrder>1</DocOrder>
            <Description>Desc1</Description>
        </RequestParameter>
        <RequestParameter>
            <ApiParameterName>RequestKey2</ApiParameterName>
            <Location>QUERY</Location>
            <ParameterType>Number</ParameterType>
            <Required>OPTIONAL</Required>
            <DefaultValue></DefaultValue>
            <DemoValue>12</DemoValue>
            <MaxValue>120</MaxValue>
            <MinValue>100</MinValue>
            <MaxLength></MaxLength>
            <MinLength></MinLength>
            <RegularExpression></RegularExpression>
            <JsonScheme></JsonScheme>
            <EnumValue></EnumValue>
            <DocShow>PUBLIC</DocShow>
            <DocOrder>2</DocOrder>
            <Description>Desc2</Description>
        </RequestParameter>
    </RequestParameters>        
</DescribeApiDocResponse>

JSON格式

{
    "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BZ014",
    "RegionId": "cn-qingdao",
    "GroupId": "0009db9c828549768a200320714b8930",
    "GroupName": "myGroup2",
    "StageName": "RELEASE",
    "ApiId": "3b81fd160f5645e097cc8855d75a1cf6",
    "ApiName": "creatobject",
    "Description": "對象創建",
    "Visibility": "public",
    "AuthType": "APP",
    "ResultType": "application/json",
    "ResultSample": "200",
    "FailResultSample": "400",
    "ErrorCodeSamples": {
        "ErrorCodeSample": [
            {
                "Code": "400",
                "Message": "Missing the parameter UserId",
                "Description": "請求缺少參數 UserId"
            }
        ]
    },
    "RequestConfig": {
      "RequestProtocol": "HTTP",
      "RequestHttpMethod": "GET",
      "RequestPath": "/mypath/creatobject",
      "BodyFormat": "FORM",
      "PostBodyDescription": "對象"
    },
    "RequestParameters": {
      "RequestParameter": [
        {
          "ApiParameterName": "RequestKey1",
          "Location": "QUERY",
          "ParameterType": "String",
          "Required": "REQUIRED",
          "DemoValue": "demo1",
          "MaxLength": "100",
          "MinLength": "3",
          "DocShow": "PUBLIC",
          "DocOrder": "1",
          "Description": "Desc1"
        },
        {
          "ApiParameterName": "RequestKey2",
          "Location": "QUERY",
          "ParameterType": "Number",
          "Required": "OPTIONAL",
          "DemoValue": "12",
          "MaxValue": "120",
          "MinValue": "100",
          "DocShow": "PUBLIC",
          "DocOrder": "2",
          "Description": "Desc2"
        }
      ]
    }
  }

最後更新：2016-11-23 17:16:09

  上一篇： 查詢API詳情__API管理相關接口_API_API 網關-阿裏雲

  下一篇： 查詢API列表__API管理相關接口_API_API 網關-阿裏雲