github/openapi/github-zen-openapi.yml at main · api-evangelist/github · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
openapi: 3.0.3
info:
  version: 1.1.4
  title: GitHub Zen API
  description: >-
    The GitHub Zen API is a simple, lighthearted endpoint that returns a random
    piece of philosophical or inspirational wisdom from GitHub's design
    philosophy when called. This playful API serves no functional purpose in
    application development but instead offers a moment of reflection, often
    sharing pithy sayings about software development, collaboration, or design
    principles that embody GitHub's cultural values. Developers sometimes use it
    as a simple test endpoint to verify API connectivity, as an Easter egg in
    applications, or simply to get a bit of inspiration during their coding
    sessions—it's GitHub's way of adding a human touch to their technical
    platform.
  license:
    name: MIT
    url: https://spdx.org/licenses/MIT
  termsOfService: https://docs.github.com/articles/github-terms-of-service
  contact:
    name: Support
    url: https://support.github.com/contact?tags=dotcom-rest-api
  x-github-plan: ghes
  x-github-release: 3.9
tags:
- name: Get
- name: Zen
servers:
- url: '{protocol}://{hostname}/api/v3'
  variables:
    hostname:
      description: Self-hosted Enterprise Server hostname
      default: HOSTNAME
    protocol:
      description: Self-hosted Enterprise Server protocol
      default: http
externalDocs:
  description: GitHub Enterprise Developer Docs
  url: https://docs.github.com/enterprise-server@3.9/rest/
paths:
  /zen:
    get:
      summary: GitHub Get the Zen of Github
      description: Get a random sentence from the Zen of GitHub
      tags:
      - Get
      - Zen
      operationId: getTheZenOfGithub
      externalDocs:
        description: API method documentation
        url: >-
          https://docs.github.com/enterprise-server@3.9/rest/meta/meta#get-the-zen-of-github
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                type: string
              examples:
                default:
                  summary: Example response
                  value: Responsive is better than fast
      x-github:
        githubCloudOnly: false
        enabledForGitHubApps: true
        category: meta
        subcategory: meta
      security:
      - bearerHttpAuthentication: []
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  examples: {}
  reponses: {}
  parameters: {}
  schemas: {}
  responses: {}
  headers: {}
  securitySchemes:
    bearerHttpAuthentication:
      description: Bearer Token
      type: http
      scheme: Bearer