import{_ as i,c as a,a2 as n,o as e}from"./chunks/framework.Dc4U0ZR1.js";const d=JSON.parse('{"title":"Integrations","description":"Automate your client generation.","frontmatter":{"title":"Integrations","description":"Automate your client generation."},"headers":[],"relativePath":"openapi-ts/integrations.md","filePath":"openapi-ts/integrations.md"}'),t={name:"openapi-ts/integrations.md"};function p(l,s,o,h,r,k){return e(),a("div",null,s[0]||(s[0]=[n(`<h1 id="integrations-soon" tabindex="-1">Integrations <span class="soon">Soon</span> <a class="header-anchor" href="#integrations-soon" aria-label="Permalink to &quot;Integrations &lt;span class=&quot;soon&quot;&gt;Soon&lt;/span&gt;&quot;">​</a></h1><div class="warning custom-block"><p class="custom-block-title">WARNING</p><p>GitHub integration is not publicly available yet. We are gathering feedback from beta testers to ensure the final product meets our quality standards. To express your interest in joining the beta test, please open an issue on <a href="https://github.com/hey-api/upload-openapi-spec/issues" target="_blank" rel="noreferrer">GitHub</a>.</p></div><p>Integrations allow you to automate your client generation workflow. Create dependency links between your clients and APIs, and watch the magic unfold. While we prefer to use <code>@hey-api/openapi-ts</code> for generating clients, you can use any codegen.</p><h2 id="upload-openapi-spec" tabindex="-1">Upload OpenAPI Spec <a class="header-anchor" href="#upload-openapi-spec" aria-label="Permalink to &quot;Upload OpenAPI Spec&quot;">​</a></h2><p>First, you need to configure your API build workflow to send us OpenAPI specifications. This can be done by adding our <a href="https://github.com/marketplace/actions/upload-openapi-spec-by-hey-api" target="_blank" rel="noreferrer">hey-api/upload-openapi-spec</a> GitHub Action into your CI workflow.</p><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">Upload OpenAPI Specification</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">on</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">  push</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">    branches</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      - </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">main</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">jobs</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">  upload-openapi-spec</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">    runs-on</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">ubuntu-latest</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">    steps</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">Checkout</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">        uses</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">actions/checkout@v4</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">      - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">Upload OpenAPI spec</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">        uses</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">hey-api/upload-openapi-spec@v1</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">        with</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">          hey-api-token</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">\${{ secrets.HEY_API_TOKEN }}</span></span>
<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">          path-to-openapi</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">path/to/openapi.json</span></span></code></pre></div><p>This step requires you to register with us in order to obtain a Hey API token. Please follow the instructions in our <a href="https://github.com/marketplace/actions/upload-openapi-spec-by-hey-api" target="_blank" rel="noreferrer">GitHub Action</a> to complete the setup. Once you have your APIs configured, you&#39;re ready to connect your clients.</p><h2 id="configure-clients" tabindex="-1">Configure Clients <a class="header-anchor" href="#configure-clients" aria-label="Permalink to &quot;Configure Clients&quot;">​</a></h2><p>More information will be provided as we finalize the tooling.</p>`,9)]))}const E=i(t,[["render",p]]);export{d as __pageData,E as default};
