Convertește curl în ColdFusion

Q: Ce este ColdFusion cfhttp?

cfhttp este tag-ul și funcția încorporată în ColdFusion pentru a efectua cereri HTTP. Suportă GET, POST, PUT, DELETE și încărcări de fișiere cu integrare nativă în scope-urile variabilelor ColdFusion. Nu este necesară nicio instalare — face parte din runtime-ul ColdFusion/Lucee. curl2code generează cod cfhttp/CFML pentru conversiile ColdFusion.

Q: Tag-ul cfhttp vs funcția cfhttp — ce sintaxă să folosesc?

Tag-ul cfhttp folosește marcaj CFML cu atribute denumite — tradițional, verbos și lizibil în fișierele de șablon. Funcția cfhttp() folosește CFScript cu argumente între paranteze: cfhttp(url=url, method="GET") — modernă și concisă. Ambele se compilează în același apel de motor. Folosiți CFScript pentru consistență în proiectele ColdFusion moderne. Pentru alegeri de sintaxă similare, consultați curl către PHP.

Q: Cum se gestionează autentificarea în ColdFusion?

Adăugați antete cu cfhttpparam type="header" name="Authorization" value="Bearer #token#". Pentru autentificarea Basic, folosiți atributele username și password direct pe cfhttp. ColdFusion gestionează automat codificarea Base64 pentru autentificarea Basic. curl2code convertește flag-urile de autentificare în CFML.

Q: Cum se trimit date de tip multipart form în ColdFusion?

Folosiți cfhttpparam type="file" name="upload" file="#filePath#" pentru încărcări de fișiere. Pentru câmpuri de formular: cfhttpparam type="formfield" name="key" value="value". ColdFusion setează automat Content-Type multipart și delimitatorii. curl2code gestionează conversiile flag-ului -F.

Q: Cum se gestionează erorile HTTP în ColdFusion?

Împachetați în try/catch: try { httpResult = cfhttp(...); } catch(any e) { ... }. Verificați cfhttp.statusCode pentru starea HTTP și cfhttp.errorDetail pentru informații despre eroare. Răspunsurile non-2xx nu aruncă erori în mod implicit — verificați întotdeauna manual codul de stare.

Q: Cum se parsează răspunsurile JSON în ColdFusion?

Folosiți deserializeJSON(cfhttp.fileContent) pentru a parsa JSON în structuri și array-uri ColdFusion. Pentru trimiterea JSON: serializeJSON(data). Funcțiile JSON din ColdFusion gestionează automat structurile imbricate complexe, convertind fără probleme între tipurile de date CFML și JSON.

Q: Cum se setează timeout-urile în ColdFusion?

Transmiteți parametrul timeout: cfhttp(url=url, timeout=30). Valoarea este în secunde. Nu există reîncercare încorporată — implementați cu o buclă și try/catch. Timeout-ul implicit variază în funcție de versiunea ColdFusion/Lucee.

Q: Cum se folosește un proxy în ColdFusion?

Transmiteți parametrii proxy: cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). Pentru autentificarea proxy, adăugați parametrii proxyUser și proxyPassword. curl2code convertește flag-urile -x în setări proxy CFML.

Q: Cum se trimite o cerere POST cu un corp JSON în ColdFusion?

Convertește o comandă curl POST precum curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL în ColdFusion folosind curl2code. Codul generat utilizează cfhttpparam type='body' value='#serializeJSON(data)#'. curl2code detectează automat flag-urile -d/--data cu conținut JSON și setează antetul Content-Type corespunzător în codul cfhttp.

Q: Cum se adaugă autorizarea prin Bearer token în ColdFusion?

Introdu curl -H "Authorization: Bearer YOUR_TOKEN" URL în curl2code și acesta va genera cod cfhttp cu antetul de autentificare: cfhttpparam type='header' name='Authorization' value='Bearer TOKEN'. curl2code detectează Bearer tokens atât din flag-urile -H "Authorization: Bearer ...", cât și din --oauth2-bearer. Pentru Basic auth, utilizează -u user:pass.

Convertește comenzile curl în cod ColdFusion folosind cfhttp. curl2code rulează integral în browserul tău prin WebAssembly — datele tale rămân private. Pentru PHP, încearcă convertorul nostru curl în PHP. Pentru Java, vezi curl în Java. Mai jos sunt exemple ColdFusion gata de utilizat.

Cum să copiezi curl din browserul tău

1
Deschide DevTools
Apasă F12 sau Ctrl+Shift+I pentru a deschide instrumentele de dezvoltare ale browserului.
2
Mergi la fila Network
Fă clic pe fila Network și efectuează acțiunea care declanșează cererea HTTP.
3
Copiază ca cURL
Fă clic dreapta pe cerere → Copy → Copy as cURL. Apoi lipește-o mai sus.

Exemple de cod ColdFusion

1Cerere GET simplă

comandă curl

curl https://api.example.com/users

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/users");
httpService.setMethod("GET");

result = httpService.send().getPrefix();
writeDump(result);

2POST cu corp JSON

comandă curl

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/users");
httpService.setMethod("POST");
httpService.addParam(type="header", name="Content-Type", value="application/json");
httpService.addParam(type="body", value='{"name":"John","email":"john@example.com"}');

result = httpService.send().getPrefix();
writeDump(result);

3Cerere cu Bearer Token

comandă curl

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/me");
httpService.setMethod("GET");
httpService.addParam(type="header", name="Authorization", value="Bearer token123");

result = httpService.send().getPrefix();
writeDump(result);

4Încărcare formular multipart

comandă curl

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/upload");
httpService.setMethod("POST");
httpService.addParam(type="file", name="file", file="#expandPath("document.pdf")#");
httpService.addParam(type="formfield", name="description", value="My file");

result = httpService.send().getPrefix();
writeDump(result);

5Antete personalizate

comandă curl

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

ColdFusion · cfhttp

httpService = new http();
httpService.setUrl("https://api.example.com/data");
httpService.setMethod("GET");
httpService.addParam(type="header", name="X-API-Key", value="abc123");
httpService.addParam(type="header", name="Accept", value="application/json");
httpService.addParam(type="header", name="X-Request-ID", value="req-456");

result = httpService.send().getPrefix();
writeDump(result);

Întrebări frecvente

Ce este ColdFusion cfhttp?

cfhttp este tag-ul și funcția încorporată în ColdFusion pentru a efectua cereri HTTP. Suportă GET, POST, PUT, DELETE și încărcări de fișiere cu integrare nativă în scope-urile variabilelor ColdFusion. Nu este necesară nicio instalare — face parte din runtime-ul ColdFusion/Lucee. curl2code generează cod cfhttp/CFML pentru conversiile ColdFusion.

Tag-ul cfhttp vs funcția cfhttp — ce sintaxă să folosesc?

Tag-ul cfhttp folosește marcaj CFML cu atribute denumite — tradițional, verbos și lizibil în fișierele de șablon. Funcția cfhttp() folosește CFScript cu argumente între paranteze: cfhttp(url=url, method="GET") — modernă și concisă. Ambele se compilează în același apel de motor. Folosiți CFScript pentru consistență în proiectele ColdFusion moderne. Pentru alegeri de sintaxă similare, consultați curl către PHP.

Cum se gestionează autentificarea în ColdFusion?

Adăugați antete cu cfhttpparam type="header" name="Authorization" value="Bearer #token#". Pentru autentificarea Basic, folosiți atributele username și password direct pe cfhttp. ColdFusion gestionează automat codificarea Base64 pentru autentificarea Basic. curl2code convertește flag-urile de autentificare în CFML.

Cum se trimit date de tip multipart form în ColdFusion?

Folosiți cfhttpparam type="file" name="upload" file="#filePath#" pentru încărcări de fișiere. Pentru câmpuri de formular: cfhttpparam type="formfield" name="key" value="value". ColdFusion setează automat Content-Type multipart și delimitatorii. curl2code gestionează conversiile flag-ului -F.

Cum se gestionează erorile HTTP în ColdFusion?

Împachetați în try/catch: try { httpResult = cfhttp(...); } catch(any e) { ... }. Verificați cfhttp.statusCode pentru starea HTTP și cfhttp.errorDetail pentru informații despre eroare. Răspunsurile non-2xx nu aruncă erori în mod implicit — verificați întotdeauna manual codul de stare.

Cum se parsează răspunsurile JSON în ColdFusion?

Folosiți deserializeJSON(cfhttp.fileContent) pentru a parsa JSON în structuri și array-uri ColdFusion. Pentru trimiterea JSON: serializeJSON(data). Funcțiile JSON din ColdFusion gestionează automat structurile imbricate complexe, convertind fără probleme între tipurile de date CFML și JSON.

Cum se setează timeout-urile în ColdFusion?

Transmiteți parametrul timeout: cfhttp(url=url, timeout=30). Valoarea este în secunde. Nu există reîncercare încorporată — implementați cu o buclă și try/catch. Timeout-ul implicit variază în funcție de versiunea ColdFusion/Lucee.

Cum se folosește un proxy în ColdFusion?

Transmiteți parametrii proxy: cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). Pentru autentificarea proxy, adăugați parametrii proxyUser și proxyPassword. curl2code convertește flag-urile -x în setări proxy CFML.

Cum se trimite o cerere POST cu un corp JSON în ColdFusion?

Convertește o comandă curl POST precum curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL în ColdFusion folosind curl2code. Codul generat utilizează cfhttpparam type='body' value='#serializeJSON(data)#'. curl2code detectează automat flag-urile -d/--data cu conținut JSON și setează antetul Content-Type corespunzător în codul cfhttp.

Cum se adaugă autorizarea prin Bearer token în ColdFusion?

Introdu curl -H "Authorization: Bearer YOUR_TOKEN" URL în curl2code și acesta va genera cod cfhttp cu antetul de autentificare: cfhttpparam type='header' name='Authorization' value='Bearer TOKEN'. curl2code detectează Bearer tokens atât din flag-urile -H "Authorization: Bearer ...", cât și din --oauth2-bearer. Pentru Basic auth, utilizează -u user:pass.

Cum se setează antetul Content-Type în ColdFusion?

curl2code convertește curl -H "Content-Type: application/json" URL în cod cfhttp cu antetul corect: cfhttpparam type='header' name='Content-Type' value='application/json'. Pentru datele -d, curl folosește implicit application/x-www-form-urlencoded; pentru încărcările de formulare -F, folosește multipart/form-data. curl2code mapează fiecare opțiune către API-ul cfhttp corect.

Linkuri utile

Documentație cfhttp

cfdocs.org

Referință bibliotecă standard

helpx.adobe.com

Pagina manual curl

curl.se

Ghiduri curl

Coduri de eroare curl

Caută orice cod de ieșire curl — cauze, rezolvări și sfaturi de depanare.

Descărcarea fișierelor cu curl

Salvează fișiere cu -o, -O, urmează redirecționări, reia descărcări și multe altele.

SSL, TLS și proxy

Configurează certificate, versiuni TLS, proxy-uri HTTP/SOCKS și DNS personalizat.

Cum să copiezi curl din browserul tău

Exemple de cod ColdFusion

1Cerere GET simplă

2POST cu corp JSON

3Cerere cu Bearer Token

4Încărcare formular multipart

5Antete personalizate

Întrebări frecvente

Linkuri utile

Ghiduri curl

Convertește curl în alte limbaje

Exemple de cod ColdFusion

1Cerere GET simplă

2POST cu corp JSON

3Cerere cu Bearer Token

4Încărcare formular multipart

5Antete personalizate