curl -F – Trimitere formular multipart/form-data și upload fișiere în Comenzi cURL

curl -F "fisier=@foto.jpg" -F "descriere=Poza mea" <url>

Ce face curl -F - Trimitere formular multipart/form-data și upload fișiere

Opțiunea -F (sau --form) este utilizată pentru a emula trimiterea unui formular HTML ce conține controale de tip ``.

curl generează automat granițele MIME (boundary) și antetele individuale pentru fiecare câmp în parte.

Pentru a încărca un fișier, adăugați prefixul @ în fața căii pe disc (ex: `fisier=@document.pdf;type=application/pdf`).

Exemple

Exemplul 1: Încărcarea unei imagini de profil și a numelui de utilizator

Trimite fișierul imagine și un parametru text asociat.

curl -F "avatar=@/home/user/avatar.png;type=image/png" \
  -F "utilizator=dexter" \
  https://api.dexblog.ro/v1/profil/avatar

Ieșire în terminal

{
  "succes": True,
  "fisier_salvat": "avatar_dexter_2026.png",
  "dimensiune": 84920
}

Greșeli frecvente

• Confuzia între -F (multipart/form-data) și -d (application/x-www-form-urlencoded); dacă un endpoint API așteaptă upload de fișiere, -d nu va funcționa.

Comenzi înrudite

• curl --data-binary - Trimitere date binare neschimbate: Transmite conținutul exact al unui fișier sau buffer binar fără a elimina caracterele newline sau carriage return.
• curl -T - Încărcare fișiere prin HTTP PUT sau FTP: Încarcă un fișier local direct pe server utilizând metoda HTTP PUT sau protocolul FTP/SFTP.
• curl -d - Trimitere date POST (application/x-www-form-urlencoded): Trimite date în corpul unei cereri POST folosind codarea standard de formulare web.