wenxin shi

My feedback

  1. 48 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    7 comments  ·  API Management » Developer portal  ·  Flag idea as inappropriate…  ·  Admin →
    under review  ·  Miao Jiang responded

    Thanks for the feedback. Can you please provide a little more details on how you want this to work? Do you want this feature on developer portal or admin portal or both? Thanks!

    wenxin shi supported this idea  · 
    wenxin shi commented  · 

    It would be good enough to include tags from swagger api doc into MenuItems so we can create custimized grouped operation list in Developer portal.

  2. 93 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Microsoft
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    6 comments  ·  API Management  ·  Flag idea as inappropriate…  ·  Admin →
    wenxin shi commented  · 

    I have same issue here, seems the APIM can only solve 2 levels of nestd $ref, if the model have deeper nested levels, it will fail. following is an example.

    {"swagger":"2.0","info":{"version":"v1","title":"testapi"},"host":"tset.com","schemes":["http"],"paths":{"/api/v1/rawevent":{"post":{"tags":["RawEvent"],"operationId":"RawEvent_Post","consumes":["application/json","text/json","application/xml","text/xml","application/x-www-form-urlencoded"],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"rawEvent","in":"body","required":true,"schema":{"$ref":"#/definitions/SimulateRawEvent"}}],"responses":{"200":{"description":"OK","schema":{"type":"array","items":{"$ref":"#/definitions/SimulateRawEvent"}}},"400":{"description":"BadRequest"},"401":{"description":"Unauthorized"}}}},"/api/v1/eventtypes":{"get":{"tags":["RawEvent"],"operationId":"EventTypes_Get","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"responses":{"200":{"description":"OK","schema":{"type":"array","items":{"$ref":"#/definitions/EventType"}}},"400":{"description":"BadRequest"},"401":{"description":"Unauthorized"}}}},"/api/v1/vehicles/events":{"get":{"tags":["Vehicles"],"operationId":"VehicleEvents_Get","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"minReceived","in":"query","required":true,"type":"string","format":"date-time"}],"responses":{"200":{"description":"OK","schema":{"type":"array","items":{"$ref":"#/definitions/VehicleEvent"}}},"400":{"description":"BadRequest"},"401":{"description":"Unauthorized"}}}},"/api/v1/vehicles/faults":{"get":{"tags":["Vehicles"],"operationId":"VehicleFaults_Get","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"minReceived","in":"query","required":true,"type":"string","format":"date-time"}],"responses":{"200":{"description":"OK","schema":{"type":"array","items":{"$ref":"#/definitions/VehicleFault"}}},"400":{"description":"BadRequest"},"401":{"description":"Unauthorized"}}}},"/api/v1/vehicles/trips":{"get":{"tags":["Vehicles"],"operationId":"VehicleTrips_Get","consumes":[],"produces":["application/json","text/json","application/xml","text/xml"],"parameters":[{"name":"minReceived","in":"query","required":true,"type":"string","format":"date-time"}],"responses":{"200":{"description":"OK","schema":{"type":"array","items":{"$ref":"#/definitions/VehicleTrip"}}},"400":{"description":"BadRequest"},"401":{"description":"Unauthorized"}}}}},"definitions":{"SimulateRawEvent":{"type":"object","properties":{"Serial":{"format":"int64","type":"integer"},"Lat":{"format":"double","type":"number"},"Long":{"format":"double","type":"number"},"SpeedMps":{"format":"float","type":"number"},"Direction":{"format":"int32","type":"integer"},"EventTypeId":{"format":"int32","type":"integer"},"Observed":{"format":"date-time","type":"string"}}},"EventType":{"type":"object","properties":{"Id":{"format":"int32","type":"integer"},"Name":{"type":"string"}}},"VehicleEvent":{"type":"object","properties":{"Serial":{"format":"int64","type":"integer"},"Received":{"format":"date-time","type":"string"},"Observed":{"format":"date-time","type":"string"},"EventTypeId":{"format":"int32","type":"integer"},"Speed":{"format":"double","type":"number"},"SpeedLimit":{"format":"double","type":"number"},"Location":{"$ref":"#/definitions/Location"},"Address":{"$ref":"#/definitions/Address"},"Direction":{"format":"int32","type":"integer"}}},"Location":{"type":"object","properties":{"Latitude":{"format":"double","type":"number"},"Longitude":{"format":"double","type":"number"}}},"Address":{"type":"object","properties":{"Street":{"type":"string"},"Town":{"type":"string"},"Postcode":{"type":"string"}}},"VehicleFault":{"type":"object","properties":{"Serial":{"format":"int64","type":"integer"},"Received":{"format":"date-time","type":"string"},"Observed":{"format":"date-time","type":"string"},"FaultCode":{"type":"string"},"IsEngineLightOn":{"type":"boolean"}}},"VehicleTrip":{"type":"object","properties":{"Serial":{"format":"int64","type":"integer"},"Received":{"format":"date-time","type":"string"},"StartPoint":{"$ref":"#/definitions/TripPoint"},"EndPoint":{"$ref":"#/definitions/TripPoint"},"Distance":{"format":"double","type":"number"}}},"TripPoint":{"type":"object","properties":{"Observed":{"format":"date-time","type":"string"},"Address":{"$ref":"#/definitions/Address"},"Location":{"$ref":"#/definitions/Location"}}}}}

    wenxin shi supported this idea  · 

Feedback and Knowledge Base