Constructor de cereri HTTP

Se compune o cerere HTTP pas cu pas — variabile de cale precum {userId}, parametri de interogare, antete, corpuri JSON/formular și autentificare — și se generează cod gata de rulat pentru cURL, Node.js fetch, Python requests sau PowerShell. Instrumentul este pentru proiectare și generare; pentru a trimite efectiv o cerere și a inspecta răspunsul în direct, cererea se trimite prin butonul Cerere de test → (se deschide Clientul REST API / Testerul), sau se convertește o comandă cURL lipită cu Convertorul de comenzi cURL.
Totul se asamblează local în browser. Nicio cerere nu este trimisă niciodată de pe această pagină.
Parametri de cale (token-uri {name} în URL-ul de mai sus)
Parametri de interogare
Antete
Corp
Autorizare
Previzualizare cURL în timp real — se actualizează pe măsură ce se scrie:
cURL Node.js fetch Python requests PowerShell
Sfaturi: un segment de URL se încadrează în acolade ({userId}) pentru a fi gestionat ca parametru de cale; codul generat se reîmprospătează la fiecare modificare. Cererile GET/HEAD ignoră un corp. Încărcările de fișiere generate folosesc cURL în stilul @file sau substituenți în celelalte limbaje — fișierele reale se atașează în propriul cod. Trimiterea între origini este acoperită de Clientul REST API (se respectă politica CORS a serverului); pentru a inversa o comandă existentă se folosește Convertorul de comenzi cURL.
Metodele HTTP explicate
Când se alege o metodă, codul generat în cURL / Node / Python / PowerShell se schimbă ca să se potrivească. Iată ce înseamnă fiecare verb pentru cererea în curs de construire:
GET — Preluarea unei reprezentări a unei resurse. Nu ar trebui să schimbe starea serverului, iar cererea generată nu are de obicei corp. Se folosește GET pentru citiri, căutări și puncte de capăt de liste.
POST — Trimiterea datelor pentru crearea unei resurse noi sau pentru declanșarea unei acțiuni. Corpul devine sarcina utilă din codul generat (--data-raw în cURL, un argument de corp în Node/Python etc.). POST nu este idempotent: trimis de două ori poate crea două resurse.
PUT — Înlocuirea completă a unei resurse existente. Se trimite obiectul complet în corp; câmpurile omise pot fi tratate ca goale. Codul generat trimite întregul corp la URL-ul exact.
PATCH — Actualizarea doar a câmpurilor incluse. Corpul transportă un set parțial de modificări, deci cererile generate sunt mai mici decât cele PUT atunci când se editează doar una sau două valori.
DELETE — Eliminarea resursei de la URL. Este idempotentă și de obicei nu are corp, deci codul generat este un simplu apel de ștergere doar cu antete.
HEAD — Cerere doar a antetelor, fără corpul răspunsului. Codul generat arată ca un GET, dar returnează metadate precum Content-Length, Last-Modified sau Content-Type, economisind lățime de bandă.
OPTIONS — Descoperirea a ce permite serverul pentru un URL, sau simularea unui preflight CORS. Antetele răspunsului (de exemplu Access-Control-Allow-Methods) arată verbele permise. OPTIONS nu are de obicei corp de cerere.
Ușor de confundat: HEAD față de GET — cererile generate sunt asemănătoare, dar HEAD nu returnează corp. PUT față de PATCH — PUT rescrie întreaga resursă; PATCH schimbă doar câmpurile furnizate.