= CDN API (Reference) =

== Общие требования ==
'''Base URL:''' https://cdnapi.denchikp.com 
'''CDN URL файлов:''' https://cdn.denchikp.com/<domain>/<folder>/<filename>

Большинство CDN‑эндпоинтов требуют:
* заголовок <code>X-Api-Key: <API_KEY></code>
или
* активную cookie‑сессию, где ключ может резолвиться автоматически (OAuth/CDN login + bind).

Во многих операциях, где передаётся <code>url</code>, принимаются '''только''' ссылки вида:
<pre>
https://cdn.denchikp.com/<domain>/<folder>/<filename>
</pre>

== Ключ / домены / квоты ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/api-key/me</code> ===
Информация о текущем API‑ключе (по <code>X-Api-Key</code> или по сессии).

'''Headers:'''
* <code>X-Api-Key: <API_KEY></code> (рекомендуется)

'''Response 200:'''
<pre>
{
"status":"ok",
"key":{
"name":"ClientName",
"is_admin":false,
"domains":["public"],
"ips":["1.2.3.4"]
}
}
</pre>

'''Ошибки:'''
* 401 — нет ключа и нет валидной авторизации

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/domains</code> ===
Список доменов, доступных для ключа.

'''Response 200 (примеры):'''
* admin‑ключ:
<pre>
{"status":"ok","mode":"any","domains":[]}
</pre>
* allowlist‑ключ:
<pre>
{"status":"ok","mode":"allowlist","domains":["public","example.com"]}
</pre>
* ключ без доменов (разрешён как минимум public):
<pre>
{"status":"ok","mode":"any","domains":["public"]}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/usage</code> ===
Текущее использование (без лимитов квоты).

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"usage":{
"total_files":120,
"total_bytes":123456789,
"month":"2026-06",
"monthly_uploaded_files":10,
"monthly_uploaded_bytes":12300000
}
}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/quota</code> ===
Квоты + использование + остатки (remaining).

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"api_key_name":"ClientName",
"is_admin":false,
"quota":{
"max_file_bytes":524288000,
"max_total_bytes":10737418240,
"max_total_files":50000,
"max_monthly_upload_bytes":5368709120,
"max_monthly_upload_files":null
},
"usage":{
"total_files":120,
"total_bytes":123456789,
"month":"2026-06",
"monthly_uploaded_files":10,
"monthly_uploaded_bytes":12300000
},
"remaining":{
"total_bytes":10000000000,
"total_files":49880,
"monthly_upload_bytes":5300000000,
"monthly_upload_files":null
}
}
</pre>

'''Ошибки:'''
* 403 — если ключ невалиден/запрещён по IP и т.п.

== Файлы (БД / meta / exists) ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/files</code> ===
Список «моих» файлов из БД.

'''Headers:'''
* <code>X-Api-Key: <API_KEY></code>

'''Query parameters (все опциональны):'''
{| class="wikitable"
! Name !! Type !! Default !! Description
|-
| q || string || — || поиск по <code>filename</code>/<code>original_filename</code> (LIKE)
|-
| domain || string || — || фильтр домена (нормализуется)
|-
| folder || string || — || фильтр папки
|-
| ext || string || — || фильтр расширения
|-
| exists_on_disk || bool || true || фильтр по наличию на диске
|-
| limit || int || 50 || максимум 200
|-
| offset || int || 0 || смещение
|}

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"total":123,
"limit":50,
"offset":0,
"files":[
{
"id":1,
"domain":"public",
"folder":"img",
"filename":"a.png",
"original_filename":"cat.png",
"url":"https://cdn.denchikp.com/public/img/a.png",
"size":12345,
"created_at":"2026-06-16T10:00:00",
"exists_on_disk":true
}
]
}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/file/meta</code> ===
Метаданные файла: сведения из БД + проверка на диске.

'''Body (JSON):'''
<pre>
{"url":"https://cdn.denchikp.com/public/img/a.png"}
</pre>

'''Response 200 (схема):'''
<pre>
{
"status":"ok",
"url":"...",
"domain":"public",
"folder":"img",
"filename":"a.png",
"db":{
"id":1,
"owner":"ClientName",
"api_key_id":10,
"size":12345,
"exists_on_disk":true,
"created_at":"..."
},
"disk":{
"exists":true,
"size":12345,
"mime_type":"image/png"
}
}
</pre>

'''Ошибки:'''
* 400 — URL не CDN формата/не парсится
* 403 — нет доступа к домену
* 401 — нет ключа

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/file/exists</code> ===
Проверка существования файла (в БД и на диске).

'''Body (JSON):'''
<pre>
{"url":"https://cdn.denchikp.com/public/img/a.png"}
</pre>

'''Response 200:'''
<pre>
{"status":"ok","exists_in_db":true,"exists_on_disk":true}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/file/redirect</code> ===
Публичный редирект на CDN URL.

'''Query:'''
* <code>?url=https://cdn.denchikp.com/...</code>

'''Ошибки:'''
* 400 — если url не начинается с <code>https://cdn.denchikp.com/</code>

== Загрузка ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/upload</code> ===
Загрузка файла (multipart/form-data).

'''Headers:'''
* <code>X-Api-Key: <API_KEY></code>

'''Content-Type:''' <code>multipart/form-data</code>
'''Max size:''' 500 MB

'''Form fields:'''
{| class="wikitable"
! Field !! Type !! Required !! Default !! Description
|-
| file || file || да || — || загружаемый файл
|-
| domain || string || нет || "" || "" → public
|-
| name_mode || string || нет || uuid || uuid | original | custom
|-
| custom_filename || string || нет || "" || используется при name_mode=custom
|-
| conflict_action || string || нет || "" || overwrite → перезаписать (с проверками прав)
|}

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"url":"https://cdn.denchikp.com/public/img/...",
"size":12345,
"owner":"ClientName",
"ip":"1.2.3.4",
"domain":"public",
"folder":"img",
"filename":"..."
}
</pre>

'''Response 409 (конфликт имени, если не overwrite):'''
<pre>
{
"status":"conflict",
"message":"FILE_EXISTS",
"requested_filename":"a.png",
"existing_url":"https://cdn.denchikp.com/public/img/a.png",
"domain":"public",
"folder":"img"
}
</pre>

'''Ошибки (частые):'''
* 403 — квота превышена / домен не разрешён / IP не разрешён / overwrite запрещён
* 413 — файл слишком большой
* 500 — внутренняя ошибка

Webhook event: <code>UPLOAD</code> (payload.source="api")

Пример (curl):
<pre>
curl -X POST "https://cdnapi.denchikp.com/upload" \
-H "X-Api-Key: <API_KEY>" \
-F "domain=public" \
-F "name_mode=uuid" \
-F "file=@./cat.png"
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/upload/by-url</code> ===
Сервер скачивает файл по ссылке и сохраняет в CDN.

'''Body (JSON):'''
<pre>
{
"source_url":"https://example.com/file.png",
"domain":"public",
"folder":"img"
}
</pre>

'''Ограничения:'''
* только http/https
* SSRF‑защита: запрещено скачивать с private/loopback/link-local/reserved/multicast адресов
* max 500 MB

'''Response 200 (пример):'''
<pre>
{"status":"ok","url":"https://cdn.denchikp.com/public/img/...","size":12345,"domain":"public","folder":"img"}
</pre>

Webhook event: <code>UPLOAD</code> (payload.source="by_url")

== Multipart Upload ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/upload/session/start</code> ===
Создать multipart‑сессию.

'''Body (JSON):'''
<pre>
{
"domain":"public",
"ext":"mp4",
"mime_type":"video/mp4",
"folder":"files"
}
</pre>

'''Response 200:'''
<pre>
{"status":"ok","upload_id":"<uuid>","chunk_size":8388608}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(251,191,36,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#fbbf24;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">PUT <code>/upload/session/{upload_id}/part/{part_no}</code> ===
Загрузить часть файла (chunk).

'''Content-Type:''' <code>multipart/form-data</code>
Form-data:
* <code>file</code> — chunk

'''Response 200:'''
<pre>
{"status":"ok","part_no":1,"bytes":8388608}
</pre>

'''Ошибки:'''
* 404 — upload_id не найден
* 403 — upload_id принадлежит другому ключу (для не‑админов)

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/upload/session/{upload_id}/complete</code> ===
Склеить части и создать итоговый файл.

'''Ошибки:'''
* 400 — нет частей
* 413 — итоговый файл > 500MB
* 403 — квота/права

Webhook event: <code>UPLOAD</code> (payload.source="multipart")

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/upload/session/{upload_id}/abort</code> ===
Отменить multipart‑сессию и удалить временные части.

'''Response 200:'''
<pre>
{"status":"ok"}
</pre>

== Операции с файлами ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/files/bulk-delete</code> ===
Удалить много файлов за один запрос (до 500 URL).

'''Body (JSON):'''
<pre>
{"urls":["https://cdn.denchikp.com/public/files/a.txt","..."]}
</pre>

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"results":[
{"url":"...","status":"ok"},
{"url":"...","status":"error","error":"..."}
]
}
</pre>

Webhook event: <code>BULK_DELETE</code>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/file/move</code> ===
Перемещение/переименование файла (можно менять домен/папку/имя).

'''Body (JSON):'''
<pre>
{
"url":"https://cdn.denchikp.com/public/img/a.png",
"new_domain":"public",
"new_folder":"files",
"new_filename":"b.png"
}
</pre>

'''Правила:'''
* <code>new_folder</code> должен быть одним из: img/css/js/fonts/files
* <code>new_filename</code> не должен содержать <code>..</code>, <code>/</code>, <code>\</code>

'''Response 200:'''
<pre>
{"status":"ok","from":"https://.../a.png","to":"https://.../b.png"}
</pre>

Webhook event: <code>FILE_MOVE</code>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/file/rename</code> ===
Переименовать файл (alias для <code>/file/move</code>, но меняется только имя).

'''Body (JSON):'''
<pre>
{
"url":"https://cdn.denchikp.com/public/img/a.png",
"new_filename":"b.png"
}
</pre>

'''Ошибки:'''
* 400 — <code>new_filename</code> обязателен

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/file/copy</code> ===
Копирование файла (квоты учитываются как новая загрузка).

'''Body (JSON):'''
<pre>
{
"url":"https://cdn.denchikp.com/public/img/a.png",
"target_domain":"public",
"target_folder":"img",
"target_filename":"copy.png"
}
</pre>

'''Response 200:'''
<pre>
{"status":"ok","url":"https://cdn.denchikp.com/public/img/copy.png","size":12345}
</pre>

Webhook event: <code>FILE_COPY</code>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/file/hash</code> ===
Посчитать хэш файла.

'''Body (JSON):'''
<pre>
{"url":"https://cdn.denchikp.com/public/files/a.bin","algo":"sha256"}
</pre>

<code>algo</code>: sha256 | sha1 | md5

'''Response 200:'''
<pre>
{"status":"ok","algo":"sha256","hash":"<hex>","url":"https://..."}
</pre>

== Browse / Folders / Download ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/browse</code> ===
Просмотр файлов на диске в домене.

'''Body (JSON):'''
<pre>
{"domain":"public","folder":"img","filter":"cat"}
</pre>

Поля:
* <code>domain</code> — обязательно
* <code>folder</code> — опционально
* <code>filter</code> — подстрока в имени файла (опционально)

'''Response 200 (схема):'''
<pre>
{"status":"ok","domain":"public","total_files":2,"files":[{"name":"a.png","path":"img/a.png","size":12345,"url":"..."}]}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/folders/{domain}</code> ===
Список папок домена + агрегаты.

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"domain":"public",
"total_files":10,
"total_size":1234567,
"folders":[{"name":"img","file_count":5,"size":1000000,"path":"public/img"}]
}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/download/{domain}/{folder}/{filename:path}</code> ===
Скачивание файла.

'''Важно:'''
хотя параметр <code>{filename:path}</code> технически может содержать “/”, сервер отклонит имя, если в нём есть <code>/</code> или <code>\</code> или <code>..</code>.

'''Response 200:'''
* бинарный поток (FileResponse), <code>application/octet-stream</code>

'''Ошибки:'''
* 404 — файл не найден
* 403 — нет доступа к домену

== Validate URL ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/validate</code> ===
Валидация ссылки (http/https). Делает HEAD, при необходимости GET range 0-0, возвращает HTTP статус и заголовки.
Если URL — CDN URL, дополнительно парсит <code>domain/folder/filename</code> и проверяет наличие на диске.

'''Body (JSON):'''
<pre>
{"url":"https://example.com/file.png"}
</pre>

'''Response 200 (схема, укорочено):'''
<pre>
{
"status":"ok",
"checked_by":"ClientName",
"url":"https://example.com/file.png",
"is_valid_url":true,
"is_cdn_url":false,
"available":true,
"http_status":200,
"headers":{"content_type":"image/png","content_length":"12345","last_modified":null,"etag":null,"server":"nginx"},
"file_info":{"filename":"file.png","extension":"png","host":"example.com","path":"/file.png"},
"cdn_info":null,
"error":null
}
</pre>

== Delete file ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(251,113,133,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#fb7185;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">DELETE <code>/delete</code> ===
Удаление файла по CDN URL.

'''Body (JSON):'''
<pre>
{"url":"https://cdn.denchikp.com/public/files/a.txt"}
</pre>

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"message":"Файл успешно удален",
"domain":"public",
"folder":"files",
"filename":"a.txt",
"url":"https://cdn.denchikp.com/public/files/a.txt",
"owner":"ClientName",
"ip":"1.2.3.4"
}
</pre>

Webhook event: <code>DELETE</code> (payload.source="api")

== Text Editor (Read/Save) ==

Только для “текстовых” файлов и ограничение по размеру: ≤ 2 MB.

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/file/content</code> ===
Получить содержимое текстового файла.

'''Body (JSON):'''
<pre>
{"url":"https://cdn.denchikp.com/public/files/app.js"}
</pre>

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"url":"https://cdn.denchikp.com/public/files/app.js",
"domain":"public",
"folder":"files",
"filename":"app.js",
"mime_type":"application/javascript",
"size":1200,
"content":"console.log('hi');\n"
}
</pre>

'''Ошибки:'''
* 400 — файл не текстовый / >2MB / неподдерживаемая кодировка
* 404 — файл не найден

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/file/save</code> ===
Сохранить содержимое текстового файла.

'''Body (JSON):'''
<pre>
{"url":"https://cdn.denchikp.com/public/files/app.js","content":"console.log('hi');\n"}
</pre>

'''Response 200:'''
<pre>
{"status":"ok","message":"Файл успешно сохранен","url":"...","domain":"public","folder":"files","filename":"app.js","size":1200}
</pre>

Webhook event: <code>FILE_SAVE</code>

----

= Webhooks (Reference) =

Webhooks позволяют получать события от сервиса (UPLOAD/DELETE и т.д.) на ваш URL.

== Создание / управление ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/webhooks</code> ===
Создать webhook.

'''Headers:'''
* <code>X-Api-Key: <API_KEY></code>

'''Body (JSON):'''
<pre>
{
"url":"https://example.com/hook",
"events":["UPLOAD","DELETE"],
"secret":"optional",
"enabled":true
}
</pre>

'''Response 200:'''
<pre>
{"status":"ok","id":123}
</pre>

'''Ошибки:'''
* 401/403 — нет доступа

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/webhooks</code> ===
Список webhooks текущего ключа.

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"webhooks":[
{
"id":123,
"url":"https://example.com/hook",
"events":["UPLOAD","DELETE"],
"enabled":true,
"created_at":"2026-06-16T12:00:00"
}
]
}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(251,113,133,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#fb7185;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">DELETE <code>/webhooks/{webhook_id}</code> ===
Удалить webhook.

'''Path params:'''
* <code>webhook_id</code> — integer

'''Response 200:'''
<pre>
{"status":"ok"}
</pre>

'''Ошибки:'''
* 404 — webhook не найден (или не принадлежит ключу)

== Delivery format ==

Сервер отправляет на URL webhook’а запрос:
* Method: POST
* Content-Type: application/json
* Body:
<pre>
{"event":"UPLOAD","payload":{...}}
</pre>

== События ==
События, которые реально используются в текущем коде:
* <code>UPLOAD</code>
* <code>DELETE</code>
* <code>BULK_DELETE</code>
* <code>FILE_MOVE</code>
* <code>FILE_COPY</code>
* <code>FILE_SAVE</code>
* <code>SCAN_FINISHED</code>

== Подпись (HMAC) ==
Если у webhook задан <code>secret</code> и на сервере включена подпись, рекомендуется добавлять:

Headers:
* <code>X-Webhook-Event: <EVENT></code>
* <code>X-Webhook-Timestamp: <unix_seconds></code>
* <code>X-Webhook-Signature: sha256=<hex></code>

Алгоритм:
* base = <code>{timestamp}.{raw_body}</code>
* signature = <code>HMAC_SHA256(secret, base)</code> (hex)
* получатель проверяет подпись и свежесть timestamp (например ±300 секунд)

''Примечание:'' в текущем коде поле <code>secret</code> хранится, но подпись нужно добавить отдельным патчем (если ещё не добавлено).

= Bot (internal) =

Все эндпоинты <code>/bot/*</code> требуют заголовок <code>X-Bot-Token</code>.

{| class="wikitable"
! Header !! Обязательно !! Описание
|-
| X-Bot-Token || да || внутренний токен, должен совпадать с <code>DISCORD_BOT_INTERNAL_TOKEN</code> на сервере
|}

== Discord binding ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/bot/discord/bind</code> ===
Привязать Discord пользователя к API‑ключу (для бота).

'''Headers:'''
* <code>X-Bot-Token: <BOT_TOKEN></code>

'''Body (JSON):'''
<pre>
{
"discord_id": "1234567890",
"api_key": "<API_KEY>",
"username": "optional",
"global_name": "optional",
"email": "optional",
"avatar": "optional"
}
</pre>

'''Response 200 (пример):'''
<pre>
{
"status": "ok",
"message": "Discord аккаунт успешно привязан к API ключу",
"discord_id": "1234567890",
"key_info": {
"name": "ClientName",
"domains": ["public"],
"enabled": true,
"is_admin": false,
"ips": []
}
}
</pre>

'''Ошибки:'''
* 403 — недействительный <code>X-Bot-Token</code>
* 400 — API ключ не существует

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/bot/discord/unbind</code> ===
Отвязать Discord пользователя от API‑ключа.

'''Headers:'''
* <code>X-Bot-Token: <BOT_TOKEN></code>

'''Body (JSON):'''
<pre>
{ "discord_id": "1234567890" }
</pre>

'''Response 200:'''
<pre>
{ "status": "ok", "message": "Discord аккаунт успешно отвязан от API ключа" }
</pre>

'''Ошибки:'''
* 403 — недействительный <code>X-Bot-Token</code>
* 404 — привязка не найдена

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/bot/discord/me/{discord_id}</code> ===
Получить информацию о привязке Discord пользователя.

'''Headers:'''
* <code>X-Bot-Token: <BOT_TOKEN></code>

'''Path params:'''
* <code>discord_id</code> — Discord ID

'''Response 200 (пример, если привязан):'''
<pre>
{
"authenticated": true,
"bound": true,
"discord_id": "1234567890",
"user": { "name": "Display Name", "email": "user@example.com", "avatar": "https://..." },
"key_info": { "name":"ClientName","domains":["public"],"enabled":true,"is_admin":false,"ips":[] }
}
</pre>

'''Response 404 (если не привязан):'''
<pre>
{ "authenticated": false, "bound": false }
</pre>

== Bot files ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/bot/upload</code> ===
Загрузка файла через Discord‑бота (multipart/form-data).

'''Headers:'''
* <code>X-Bot-Token: <BOT_TOKEN></code>

'''Content-Type:''' <code>multipart/form-data</code>
'''Max file size:''' 500 MB

'''Form fields:'''
{| class="wikitable"
! Field !! Type !! Required !! Default !! Description
|-
| discord_id || string || да || — || Discord ID
|-
| file || file || да || — || файл
|-
| domain || string || нет || "" || "" → public
|-
| name_mode || string || нет || uuid || uuid | original | custom
|-
| custom_filename || string || нет || "" || используется при custom
|-
| conflict_action || string || нет || "" || overwrite → перезаписать (с проверками)
|}

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"url":"https://cdn.denchikp.com/public/img/...",
"size":12345,
"owner":"ClientName",
"domain":"public",
"folder":"img",
"filename":"..."
}
</pre>

'''Response 409 (если имя занято и overwrite не задан):'''
<pre>
{
"status":"conflict",
"message":"FILE_EXISTS",
"requested_filename":"a.png",
"existing_url":"https://cdn.denchikp.com/public/img/a.png",
"domain":"public",
"folder":"img"
}
</pre>

'''Ошибки (частые):'''
* 401 — Discord аккаунт не привязан к API ключу
* 403 — нет доступа к домену / квота / overwrite запрещён
* 413 — файл слишком большой
* 500 — внутренняя ошибка

Пример (curl):
<pre>
curl -X POST "https://cdnapi.denchikp.com/bot/upload" \
-H "X-Bot-Token: <BOT_TOKEN>" \
-F "discord_id=1234567890" \
-F "domain=public" \
-F "name_mode=uuid" \
-F "file=@./cat.png"
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(251,113,133,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#fb7185;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">DELETE <code>/bot/delete</code> ===
Удалить файл через бота.

'''Headers:'''
* <code>X-Bot-Token: <BOT_TOKEN></code>

'''Body (JSON):'''
<pre>
{ "discord_id":"1234567890", "url":"https://cdn.denchikp.com/public/files/a.txt" }
</pre>

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"message":"Файл успешно удален",
"domain":"public",
"folder":"files",
"filename":"a.txt",
"url":"https://cdn.denchikp.com/public/files/a.txt",
"owner":"ClientName"
}
</pre>

'''Ошибки:'''
* 400 — некорректный URL / путь не файл
* 401 — Discord аккаунт не привязан
* 403 — нет доступа к домену
* 404 — файл не найден

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/bot/download/{discord_id}/{domain}/{folder}/{filename:path}</code> ===
Получить ссылки на скачивание (CDN URL + API download URL).

'''Headers:'''
* <code>X-Bot-Token: <BOT_TOKEN></code>

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"owner":"ClientName",
"domain":"public",
"folder":"img",
"filename":"a.png",
"size":12345,
"cdn_url":"https://cdn.denchikp.com/public/img/a.png",
"api_download_url":"https://cdnapi.denchikp.com/download/public/img/a.png"
}
</pre>

'''Ошибки:'''
* 400 — недопустимое имя файла (.. или / или \)
* 401 — Discord аккаунт не привязан
* 403 — нет доступа к домену
* 404 — файл не найден

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/bot/browse</code> ===
Просмотр файлов домена через бота.

'''Headers:'''
* <code>X-Bot-Token: <BOT_TOKEN></code>

'''Body (JSON):'''
<pre>
{ "discord_id":"1234567890", "domain":"public", "folder":"img", "filter":"cat" }
</pre>

'''Response 200 (пример, укорочено):'''
<pre>
{ "status":"ok", "domain":"public", "total_files":1, "files":[{"name":"a.png","path":"img/a.png","size":12345,"url":"..."}] }
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/bot/folders/{discord_id}/{domain}</code> ===
Папки домена через бота + статистика по папкам.

'''Headers:'''
* <code>X-Bot-Token: <BOT_TOKEN></code>

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"domain":"public",
"total_files":10,
"total_size":1234567,
"folders":[{"name":"img","file_count":5,"size":1000000,"path":"public/img"}]
}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/bot/validate</code> ===
Валидация ссылки через бота (HEAD/GET, статус и заголовки). Для CDN URL также возвращает parsed info и exists_on_disk.

'''Headers:'''
* <code>X-Bot-Token: <BOT_TOKEN></code>

'''Body (JSON):'''
<pre>
{ "discord_id":"1234567890", "url":"https://example.com/file.png" }
</pre>

'''Response 200 (схема, укорочено):'''
<pre>
{
"status":"ok",
"checked_by":"ClientName",
"url":"https://example.com/file.png",
"is_valid_url":true,
"is_cdn_url":false,
"available":true,
"http_status":200,
"headers":{"content_type":"image/png","content_length":"12345"},
"file_info":{"filename":"file.png","extension":"png","host":"example.com","path":"/file.png"},
"cdn_info":null,
"error":null
}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(52,211,153,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#34d399;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">POST <code>/bot/file/content</code> ===
Получить содержимое текстового файла (предпросмотр для бота).

'''Ограничения:'''
* только текстовые файлы
* размер ≤ 2 MB

'''Body (JSON):'''
<pre>
{ "discord_id":"1234567890", "url":"https://cdn.denchikp.com/public/files/app.js" }
</pre>

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"url":"https://cdn.denchikp.com/public/files/app.js",
"domain":"public",
"folder":"files",
"filename":"app.js",
"mime_type":"application/javascript",
"size":1200,
"content":"console.log('hi');\n"
}
</pre>

== Bot stats ==

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/bot/public-summary</code> ===
Публичная статистика CDN (вызов внутри бота). Фактически возвращает то же, что <code>GET /stats/public-summary</code>, но требует <code>X-Bot-Token</code>.

'''Response 200 (пример):'''
<pre>
{
"status":"ok",
"stats":{
"uploaded_files":1000,
"current_files":900,
"total_size_bytes":123456789,
"total_size_mb":117.74,
"domains":10,
"clients":3,
"registered_api_clients":5
}
}
</pre>

----

=== <span style="display:inline-flex;align-items:center;justify-content:center;padding:2px 10px;border-radius:10px;background:rgba(255,255,255,.06);border:1px solid rgba(96,165,250,.55);box-shadow:0 1px 0 rgba(255,255,255,.06) inset,0 6px 18px rgba(0,0,0,.18);color:#60a5fa;font-weight:800;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.78em;letter-spacing:.10em;text-transform:uppercase;line-height:1.1;vertical-align:middle;">GET <code>/bot/stats/{discord_id}</code> ===
Админ‑статистика для бота: доступно только если привязанный к <code>discord_id</code> ключ имеет <code>is_admin=true</code>. Возвращает ту же структуру, что <code>/bot/public-summary</code>.

'''Ошибки:'''
* 403 — только администраторы могут просматривать статистику
* 401 — Discord аккаунт не привязан к API ключу

Denchikp:

<div id="utc-clock-panel" style="
background-color: #404040;
padding: 15px;
margin: 10px 0;
border: 2px solid #ccc;
border-radius: 8px;
text-align: center;
font-family: 'Segoe UI', sans-serif;
">
<div style="font-size: 1.2em; font-weight: bold; margin-bottom: 8px;">
Текущее время и дата у участника [[Участник:Denchikp|Denchikp]]
</div>
<div id="utc-clock-time" style="font-size: 2.5em; font-weight: bold;">Загрузка времени...</div>
<div id="utc-clock-date" style="font-size: 1.2em; color: #fff;">Загрузка даты...</div>
</div>

{| class="calendar-table"
|+ '''Сентябрь 2025'''
! Пн !! Вт !! Ср !! Чт !! Пт !! Сб !! Вс
|-
| {{Календарный_день|текст=#ffffff|дата=31|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=1|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=2|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=3|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=4|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=5|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=6|статус=День окончен|цвет=#d9092c}}
|-
| {{Календарный_день|текст=#ffffff|дата=7|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=8|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=9|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=10|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=11|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=12|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=13|статус=День окончен|цвет=#d9092c}}
|-
| {{Календарный_день|текст=#ffffff|дата=14|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=15|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=16|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=17|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=18|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=19|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=20|статус=День окончен|цвет=#d9092c}}
|-
| {{Календарный_день|текст=#ffffff|дата=21|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=22|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=23|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=24|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=25|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=26|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=27|статус=День окончен|цвет=#d9092c}}
|-
| {{Календарный_день|текст=#ffffff|дата=28|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|текст=#ffffff|дата=29|статус=День окончен|цвет=#d9092c}}
| {{Календарный_день|дата=30|статус=Занят до 16:00|цвет=#e88a8a}}
| {{Календарный_день|дата=1|статус=Выходной|цвет=#ffa500}}
| {{Календарный_день|дата=2|статус=Занят до 15:00|цвет=#e88a8a}}
| {{Календарный_день|дата=3|статус=Свободен|цвет=#88d888}}
| {{Календарный_день|дата=4|статус=Свободен|цвет=#88d888}}
|}
----

__NOTOC__
<div style="border:1px solid #fff; background:#404040; padding:15px; border-radius:6px; font-size:110%; margin-bottom:1em;">
'''ℹ️ Статусы:''' 
Свободен - Никаких дел, свободное время. Можно спокойно заниматься чем хочется. 
Занят - Есть дела, работа или запланировано что-то важное. Может быть занят весь день или до определённого времени. 
Отдыхаю - Просто отдыхаю. Никаких планов, дел или спешки. Наслаждаюсь временем для себя. Иногда отдыхаю в конце дня — после дел, ближе к вечеру. 
Сплю... - Сейчас я отдыхаю и набираюсь сил. Не доступен до пробуждения. 
День окончен - Все дела завершены, ничего больше не запланировано. Можно расслабиться, день подошёл к концу.
 
Выходной - Праздничный или официальный выходной. День для отдыха, без обычных дел и забот.
</div>

ShadowLabs:Classic

2025-06-23T20:55:48Z

Denchikp:

<h2>Правила сервера | [RUS] ShadowLabs // Classic</h2> 
 
Правила приличия: 
 
[1] Явные (не шуточные) оскорбления запрещены (шутка или нет, решает оскорбленный). 
[ Мьют на 15 минут, Если продолжится наказание x2, если после этого продолжается бан на 30 минут. ] 
 
[2] Запрещено издавать неприятные звуки, орать во всю глотку. SoundPad разрешен только в подходящих для него ситуациях (Пример: прилетел МОГ, командир кричит: "За республику!", в ответ через SoundPad: "Ah yes sir". Если вас просят выключить - лучше выключить.) [ Мьют на 15 минут, Если продолжится наказание x2, если после этого продолжается бан на 30 минут. ] 
 
[3] Пиар сторонних проектов запрещён. [ Решает администрация. ] 
 
[4] Разжигание межнациональной и религиозной розни на сервере запрещено. [ Решает администрация. ] 
 
[5] Репорты/жалобы, не касающиеся нарушения правил сервера, будут приняты как шуточные. [ Бан на 30 минут, Исключение: Если вы не можете говорить вы можете отправить сообщение через репорт на админа и написать то что вам надо но не злоупотреблять. ] 
 
Правила геймплея: 
 
[1] Тимминг с враждебными классами полностью запрещен. [ Бан на 15 минут. ] 
 
[2] Кемпинг за SCP объекты (SCP-079 не считается), Повстанцев Хаоса, МОГ - запрещён (кроме SCP-106 на его спавне). Время кемпинга не должно превышать 1 мин. [ Бан в зависимости от длительности кемпинга. ] 
 
[3] Нельзя убивать Класс Д, Научных Сотрудников если они связаны, будут связаны, или они уже под опекой кого либо.
 
[ Бан на 30 минут. ]
 
 
[4] Нельзя подставлять союзные классы. (Подставой является закрытие дверей, вызов лифтов перед союзниками в случаи угрозы жизни)
 

[4.1] Класс Д нейтрален ко всем, даже к самим себе, кроме Повстанцев Хаоса. Они могут подставлять свой же класс. 
 
[ Бан на 15 минут, Исключение: Пункт 4.1 и критическая ситуация в которой могут погибнуть все/большая часть. ]
 
 
[5] Читы и багоюз запрещен. [ Сначала: Репорт на ваш аккаунт за читы + Потом: Бан навсегда. ] 
 
[6] Запрещено за SCP-343 (Бог) мешать игрокам. (Мешать SCP также нельзя, Исключение: Не открывать дверь которую просит открыть SCP) [ Бан на 15 минут. ] 
 
[7] Запрещено за SCP-035 мешать другим SCP если те не мешали вам.
 [ Бан на 15 минут. ] 
 
Правила дружественного огня:
 
 
[1] Запрещено стрелять по союзникам, просто не за что. [ Бан на 30 минут, Исключение: Если вы попали случайно, не заметили что это ваш союзник или в опасной ситуации и человек не собирается кидать репорт на игрока. ] 
 

[2] Запрещено бросать гранату в лифте полный вашими союзниками. [ Бан на 1 час, Исключение: Если в лифте был SCP или другой враждебный класс ] 
 
Другое: 
 
[1] Игнорирование, Оскорбление Администрации [ Бан на 1 день, Если что-то серьезное и вы игнорировали то наказание x2 ] 
 
[2] Попытки DDoS/DoS или другие типы атаки запрещены. [ Бан навсегда, Дополнение: Если у вас есть свой проект мы имеем право отправить на ваш сервер/проект жалобу за DDoS/DoS нашего сервера. ] 
 
[3] Нагрузка спамом предметов запрещена. [ Решает администрация, Длительность наказание идет от количества и длительности спама. ] 
 
[4] Попытки обхода наказания запрещены. [ Новый аккаунт или другие типы к примеру: Новый IP, Новое устройство или VPN будут забанены по той причине по который вас забанили. ] 
 
Дополнения: 
 
[1] При нарушении данных правил категорически запрещено использовать любой из его пунктов в свою пользу. 
 
[2] Любые средства отданные на привилегии/развитие сервера не будут возвращены ни при каких условиях. 
 
[3] Незнание правил не освобождает вас от ответственности. Нынешним и настоящим, все участники сервера автоматически соглашаются с правилами сервера тем, что являются участниками сервера. 
 
[4] Администрация всегда права и её действия не подлежат обсуждению. Если вы сомневаетесь, то вам в канал с жалобами. 
 
[5] Если что-то не написано в правилах это не значит что это разрешено. Ведите себя как адекватные люди. 
 
[6] Не надо "Тыкать" нас в правила Администраторов мы прекрасно всё знаем! 
 
 
Последное изменение правил было 21 ноября 2024 г.