Daniel Legt
df91fe9d3d
- Implement dynamic expiry options on the upload page based on user roles and retention policies. - Add helper functions to build and format expiry options into human-readable labels. - Introduce a new modern theme featuring glassmorphism, gradients, and frosted glass cards.
98 lines
4.5 KiB
HTML
98 lines
4.5 KiB
HTML
{{define "api.html"}}{{template "base" .}}{{end}}
|
|
|
|
{{define "content"}}
|
|
<section class="docs-view" aria-labelledby="api-title">
|
|
<div class="docs-header">
|
|
<p class="kicker">Developer docs</p>
|
|
<h1 id="api-title">Warpbox API</h1>
|
|
<p>Anonymous uploads for curl, scripts, and ShareX. The upload endpoint accepts multipart files and returns either plain text or JSON based on the <code>Accept</code> header.</p>
|
|
</div>
|
|
|
|
<div class="docs-grid">
|
|
<article class="card docs-card">
|
|
<div class="card-content">
|
|
<h2>Endpoints</h2>
|
|
<dl class="endpoint-list">
|
|
<div><dt>Upload</dt><dd><code>POST /api/v1/upload</code></dd></div>
|
|
<div><dt>Health</dt><dd><code>GET /api/v1/health</code></dd></div>
|
|
<div><dt>Request schema</dt><dd><a href="/api/v1/schemas/upload-request.json"><code>/api/v1/schemas/upload-request.json</code></a></dd></div>
|
|
<div><dt>Response schema</dt><dd><a href="/api/v1/schemas/upload-response.json"><code>/api/v1/schemas/upload-response.json</code></a></dd></div>
|
|
</dl>
|
|
</div>
|
|
</article>
|
|
|
|
<article class="card docs-card">
|
|
<div class="card-content">
|
|
<h2>Curl upload</h2>
|
|
<p>Without a JSON <code>Accept</code> header, Warpbox prints one plain box URL for shell-friendly usage.</p>
|
|
<pre><code>curl -F file=@./report.pdf {{.Data.UploadURL}}</code></pre>
|
|
<p>For automation, request JSON to get file URLs and the private manage/delete URLs.</p>
|
|
<pre><code>curl -F file=@./report.pdf \
|
|
-H 'Accept: application/json' \
|
|
{{.Data.UploadURL}}</code></pre>
|
|
</div>
|
|
</article>
|
|
|
|
<article class="card docs-card">
|
|
<div class="card-content">
|
|
<h2>JSON response</h2>
|
|
<p>The raw delete token is returned only once inside <code>manageUrl</code> and <code>deleteUrl</code>. Keep those links private.</p>
|
|
<pre><code>{
|
|
"boxId": "abc123",
|
|
"boxUrl": "{{.Data.BaseURL}}/d/abc123",
|
|
"zipUrl": "{{.Data.BaseURL}}/d/abc123/zip",
|
|
"manageUrl": "{{.Data.BaseURL}}/d/abc123/manage/private-token",
|
|
"deleteUrl": "{{.Data.BaseURL}}/d/abc123/manage/private-token/delete",
|
|
"expiresAt": "2026-06-05T12:00:00Z",
|
|
"files": [
|
|
{
|
|
"id": "file123",
|
|
"name": "report.pdf",
|
|
"size": "2.4 MiB",
|
|
"url": "{{.Data.BaseURL}}/d/abc123/f/file123"
|
|
}
|
|
]
|
|
}</code></pre>
|
|
</div>
|
|
</article>
|
|
|
|
<article class="card docs-card">
|
|
<div class="card-content">
|
|
<h2>ShareX setup</h2>
|
|
<ol class="docs-steps">
|
|
<li>Download the instance config: <a href="/api/v1/sharex/warpbox-anonymous.sxcu"><code>/api/v1/sharex/warpbox-anonymous.sxcu</code></a>.</li>
|
|
<li>Or open the tracked template at <code>{{.Data.ShareXExamplePath}}</code> and change <code>RequestURL</code> to <code>{{.Data.ShareXExampleURL}}</code>.</li>
|
|
<li>Keep <code>FileFormName</code> as <code>{{.Data.ShareXFileFieldName}}</code>.</li>
|
|
<li>Import the <code>.sxcu</code> file into ShareX as a custom uploader.</li>
|
|
<li>Upload a file. ShareX will use <code>boxUrl</code> as the public URL and <code>manageUrl</code> as the deletion URL.</li>
|
|
</ol>
|
|
<pre><code>{
|
|
"RequestMethod": "POST",
|
|
"RequestURL": "{{.Data.ShareXExampleURL}}",
|
|
"Headers": { "Accept": "application/json" },
|
|
"Body": "MultipartFormData",
|
|
"FileFormName": "{{.Data.ShareXFileFieldName}}",
|
|
"URL": "$json:boxUrl$",
|
|
"DeletionURL": "$json:manageUrl$"
|
|
}</code></pre>
|
|
</div>
|
|
</article>
|
|
|
|
<article class="card docs-card docs-card-wide">
|
|
<div class="card-content">
|
|
<h2>Multipart fields</h2>
|
|
<div class="field-grid">
|
|
<span><code>file</code></span><p>One or more files for curl, browser, and generic multipart clients.</p>
|
|
<span><code>sharex</code></span><p>One or more files from ShareX custom uploader configs.</p>
|
|
<span><code>max_days</code></span><p>Optional number of days before expiration. Defaults to 7.</p>
|
|
<span><code>expires_minutes</code></span><p>Optional lifetime in minutes. Takes precedence over <code>max_days</code> when greater than zero — useful for sub-day expiries (e.g. <code>60</code> for one hour).</p>
|
|
<span><code>max_downloads</code></span><p>Optional download count limit.</p>
|
|
<span><code>password</code></span><p>Optional password required before viewing/downloading.</p>
|
|
<span><code>obfuscate_metadata</code></span><p>Optional <code>on</code>; hides names/counts until unlock when a password is set.</p>
|
|
</div>
|
|
</div>
|
|
</article>
|
|
</div>
|
|
</section>
|
|
{{end}}
|