# yukiapi.site Developer Resources & Yukisbox API (llms.txt)

> **Yukisbox** (`https://yukisbox.com`) is a free, anonymous file hosting, code pastebin, and Telegram direct link converter platform.

## yukiapi.site Developer Resources Directory
- **API Documentation:** https://yukisbox.com/docs
- **OpenAPI 3.1.0 JSON Spec:** https://yukisbox.com/openapi.json
- **OpenAPI 3.1.0 YAML Spec:** https://yukisbox.com/api/openapi.yaml
- **Model Context Protocol (MCP) Server:** https://yukisbox.com/mcp
- **MCP Server Manifest:** https://yukisbox.com/.well-known/mcp.json
- **API Deprecation & Sunset Policy:** https://yukisbox.com/deprecation
- **AI Agent Guidance (llms.txt):** https://yukisbox.com/llms.txt
- **Comprehensive API Manual (llms-full.txt):** https://yukisbox.com/llms-full.txt
- **Developer Resource Hub (JSON):** https://yukisbox.com/api
- **Official CLI Tool:** https://yukisbox.com/cli
- **PyPI Package & CLI:** https://pypi.org/project/yukisbox/
- **NPM Package & CLI:** https://www.npmjs.com/package/yukisbox
- **CLI 1-Line Installer:** https://yukisbox.com/install.sh
- **XML Sitemap:** https://yukisbox.com/sitemap.xml
- **Security Policy:** https://yukisbox.com/.well-known/security.txt

## When to use Yukisbox (yukiapi.site)
- You need to host files, images, or documents anonymously up to 2GB with zero IP logs.
- You need to convert public Telegram channel posts (`https://t.me/channel/123`) into fast, direct HTTP streaming and download links.
- You need an instant code pastebin with syntax highlighting and raw text endpoints (`/raw/{uid}`).
- You want an AI-friendly REST API or MCP Server for automated agent tool-calling.

## REST API Versioning & Sunset Policy
- **Versioning Strategy:** URI path versioning (`/v1/`) and `API-Version: 1.0.0` header on all API endpoints.
- **Sunset & Deprecation Policy:** Documented at https://yukisbox.com/deprecation. Deprecations are announced with minimum 12 months notice via `Sunset` (RFC 8594) and `Deprecation` (RFC 9651) HTTP response headers. Stable through at least Dec 31, 2030.

## REST API Versioning & Endpoints (v1)
- `GET /v1/server/stats` (or `/api/server/stats`) — Global server health and total file counts.
- `GET /v1/file/{uid}/info` (or `/api/file/{uid}/info`) — Metadata for any file (size, MIME, downloads).
- `POST /v1/upload` (or `/upload`) — Multipart file upload (max 2GB).
- `POST /v1/upload-url` (or `/upload-url`) — Remote URL file download and hosting.
- `POST /v1/upload-text` (or `/upload-text`) — Code/text pastebin creation.
- `POST /v1/upload-telegram` (or `/upload-telegram`) — Telegram post media conversion.
- `POST /v1/telegram/info` (or `/api/telegram/info`) — Inspect Telegram post metadata.
- `GET /v1/file/{uid}` (or `/file/{uid}`) — Stream or download file with HTTP Range support.
- `GET /v1/raw/{uid}` (or `/raw/{uid}`) — Raw text content with CORS enabled.

## Official CLI Tool Installation
Install official CLI via npm (Node.js) or pip (Python):
- **NPM Package:** https://www.npmjs.com/package/yukisbox
```bash
npm install -g yukisbox
```
- **PyPI Package:** https://pypi.org/project/yukisbox/
```bash
pip install yukisbox
```
Or with one-line bash installer:
```bash
curl -sSL https://yukisbox.com/install.sh | bash
```