Fișiere

Încarcă un fișier

POST /api/upload

Trimiteți o cerere multipart/form-data cu câmpul file.

Restricții

Parametru	Valoare
Dimensiune maximă	200 MB
Formate imagini acceptate	JPEG, PNG, GIF, WebP
Formate video acceptate	MP4, WebM, MOV

Răspuns succes - 201 Created

{
  "upload": {
    "slug":       "aB3kX9",
    "title":      null,
    "url":        "https://pixhub.ro/i/aB3kX9",
    "direct_url": "https://pixhub.ro/i/aB3kX9.jpg",
    "thumb_url":  "https://pixhub.ro/t/aB3kX9",
    "mime_type":  "image/jpeg",
    "size":       204800,
    "views":      0,
    "likes":      0,
    "created_at": "2026-06-28T12:00:00+00:00"
  }
}

Cost cerere: Fiecare încărcare consumă 10 unități de cotă. Un cont cu limita implicită poate efectua până la 6 încărcări pe minut.

---

Listează fișierele

GET /api/uploads

Returnează fișierele proprii, cele mai recente primele, câte 50 per pagină.

Parametri de interogare

Parametru	Tip	Descriere
page	întreg	Numărul paginii (implicit: 1)

Răspuns succes - 200 OK

{
  "data": [ { /* obiect fișier */ }, ... ],
  "current_page": 1,
  "last_page": 4,
  "per_page": 50,
  "total": 183
}

---

Obține un fișier individual

GET /api/uploads/{slug}

Returnează detaliile complete ale unui fișier propriu identificat prin slug-ul său.

Răspuns succes - 200 OK

{
  "upload": { /* obiect fișier */ }
}

Returnează 404 dacă slug-ul nu există sau nu aparține contului dvs.

---

Șterge un fișier

DELETE /api/uploads/{slug}

Șterge permanent un fișier și miniatura asociată. Acțiunea nu poate fi anulată.

Răspuns succes - 200 OK

{
  "deleted": true
}

Returnează 404 dacă slug-ul nu există sau nu aparține contului dvs.

Cost cerere: Fiecare ștergere consumă 3 unități de cotă.

---

Obiectul fișier

Câmp	Tip	Descriere
slug	string	Identificator unic al fișierului
title	string | null	Titlul setat de utilizator
url	string	URL-ul paginii fișierului pe PixHub
direct_url	string	URL direct către fișierul brut
thumb_url	string | null	URL miniatură (poate fi null pentru fișiere noi)
mime_type	string	Tipul MIME al fișierului
size	întreg	Dimensiunea fișierului în octeți
views	întreg	Număr total de vizualizări
likes	întreg	Număr de aprecieri
created_at	string ISO 8601	Momentul încărcării