openapi-directory
Version:
Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS
1 lines • 6.11 kB
JSON
{"openapi":"3.0.0","info":{"contact":{"x-twitter":"halo"},"description":"API that provides Profile information about Players.","title":"Profile","version":"1.0","x-apisguru-categories":["entertainment"],"x-logo":{"url":"https://twitter.com/halo/profile_image?size=original"},"x-origin":[{"format":"swagger","url":"https://developer.haloapi.com/docs/services/58acdc2e21091812784ce8c2/export?DocumentFormat=Swagger","version":"2.0"}],"x-providerName":"haloapi.com","x-serviceName":"profile"},"security":[{"apiKeyHeader":[]},{"apiKeyQuery":[]}],"tags":[],"paths":{"/h5/profiles/{player}/appearance":{"get":{"description":"<p>This Endpoint retrieves appearance information for a player.</p>\n<p>If the player is a member of a Company, the Company's ID and Name will be provided. Additional Company information is available via the Stats API.</p>\n<br />\n<h4>Changelog</h4>\n<div class=\"panel-body\">\n <p><strong>July 14, 2017:</strong></p>\n <ul>\n <li>Added Endpoint.</li>\n </ul>\n</div>\n","operationId":"5969689a2109180f287972a8","parameters":[{"description":"The Player's Gamertag","in":"path","name":"player","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The response body will contain the Metadata for the Player-created Game Variant.","content":{"application/json":{"examples":{"response":{"value":{"Company":{"Id":"guid","Name":"string"},"FirstModifiedUtc":{"ISO8601Date":"string"},"Gamertag":"string","LastModifiedUtc":{"ISO8601Date":"string"},"ServiceTag":"string"}}}}}},"404":{"description":"Specified Player was not found."},"500":{"description":"Internal Server Error."}},"summary":"Halo 5 - Player Appearance"}},"/h5/profiles/{player}/emblem":{"get":{"description":"<p>This Endpoint returns an HTTP Redirect (302 Found) response to the caller with the URL of an image of the Player's Emblem. The initial request to this API that returns the HTTP Redirect is throttled and requires a Subscription Key. However, the image itself (at hostname \"image.halocdn.com\") is not throttled and does not require a Subscription Key. Note that if the Player later changes their Emblem, the image itself is not refreshed and will need to be refreshed via a new request to this API.</p>\n<br />\n<h4>Changelog</h4>\n<div class=\"panel-body\">\n <p><strong>July 14, 2017:</strong></p>\n <ul>\n <li>Renamed Endpoint from \"Halo 5 - Emblem Image\" to \"Halo 5 - Player Emblem Image\".</li>\n </ul>\n <p><strong>February 21, 2017:</strong></p>\n <ul>\n <li>Renamed Endpoint from \"Emblem Image\" to \"Halo 5 - Emblem Image\".</li>\n <li>Removed \"{title}\" Request Parameter.</li>\n </ul>\n</div>\n","operationId":"58acdc2e2109180bdcacc404","parameters":[{"description":"The Player's Gamertag.","in":"path","name":"player","required":true,"schema":{"type":"string"}},{"description":"An optional size (specified in pixels) of the image requested. When specified, this value must be one of the following values: 95, 128, 190, 256, 512. If a value is specified that is not in this list, the API returns HTTP 400 (\"Bad Request\"). If the size is empty or missing, the API will use 256.","in":"query","name":"size","schema":{"type":"number"}}],"responses":{"302":{"description":"Golden Path. The Location header should point at the corresponding Emblem image."},"400":{"description":"An unsupported value was provided for a query string parameter."},"404":{"description":"Specified Player was not found."},"500":{"description":"Internal Server Error."}},"summary":"Halo 5 - Player Emblem Image"}},"/h5/profiles/{player}/spartan":{"get":{"description":"<p>This Endpoint returns an HTTP Redirect (302 Found) response to the caller with the URL of an image of the Player's Spartan's appearance. The initial request to this API that returns the HTTP Redirect is throttled and requires a Subscription Key. However, the image itself (at hostname \"image.halocdn.com\") is not throttled and does not require a Subscription Key. Note that if the Player later changes their Spartan's appearance, the image itself is not refreshed and will need to be refreshed via a new request to this API.</p>\n<br />\n<h4>Changelog</h4>\n<div class=\"panel-body\">\n <p><strong>July 14, 2017:</strong></p>\n <ul>\n <li>Renamed Endpoint from \"Halo 5 - Spartan Image\" to \"Halo 5 - Player Spartan Image\".</li>\n </ul>\n <p><strong>February 21, 2017:</strong></p>\n <ul>\n <li>Renamed Endpoint from \"Spartan Image\" to \"Halo 5 - Spartan Image\".</li>\n <li>Removed \"{title}\" Request Parameter.</li>\n </ul>\n</div>\n","operationId":"58acdc2e2109180bdcacc405","parameters":[{"description":"The Player's Gamertag.","in":"path","name":"player","required":true,"schema":{"type":"string"}},{"description":"An optional size (specified in pixels) of the image requested. When specified, this value must be one of the following values: 95, 128, 190, 256, 512. If a value is specified that is not in this list, the API returns HTTP 400 (\"Bad Request\"). If the size is empty or missing, the API will use 256.","in":"query","name":"size","schema":{"type":"number"}},{"description":"An optional crop that will be used to determine what portion of the Spartan is returned in the image. The value must be either \"full\" or \"portrait\". If no value is specified \"full\" is used. If an unsupported value is provided, the API returns HTTP 400 (\"Bad Request\").","in":"query","name":"crop","schema":{"type":"string"}}],"responses":{"302":{"description":"Golden Path. The Location header should point at the corresponding Spartan image."},"400":{"description":"An unsupported value was provided for a query string parameter."},"404":{"description":"Specified Player was not found."},"500":{"description":"Internal Server Error."}},"summary":"Halo 5 - Player Spartan Image"}}},"servers":[{"url":"https://www.haloapi.com/profile"}],"components":{"securitySchemes":{"apiKeyHeader":{"in":"header","name":"Ocp-Apim-Subscription-Key","type":"apiKey"},"apiKeyQuery":{"in":"query","name":"subscription-key","type":"apiKey"}}}}