Chuyển đổi cURL

Công cụ chuyển đổi cURL là gì?

Công cụ chuyển đổi cURL biến một lệnh curl, định dạng mà mọi tài liệu API, bản xuất từ Postman và trợ lý AI đều dùng, thành code dán vào dùng ngay cho ngôn ngữ lập trình bạn thật sự dùng. Header, query string, body JSON, upload multipart, basic auth và cookie đều được chuyển sang, nên bạn không phải tự dịch request bằng tay.

curl là cách phổ biến nhất để mô tả một HTTP request, nhưng bạn hiếm khi *chạy* curl trong môi trường production. Bạn chạy fetch của JavaScript, requests của Python, net/http của Go hoặc bất cứ thứ gì stack của bạn dùng. Công cụ này lấp khoảng trống đó: dán curl, nhấn một tab, sao chép code.

Mọi thứ chạy cục bộ trong trình duyệt. Lệnh curl, header và token của bạn không bao giờ rời khỏi máy, rất hữu ích khi bạn dán lệnh có chứa bearer token hay cookie phiên thật.

Bạn học được gì khi chuyển đổi

• Các cờ của curl tương ứng với những khái niệm cụ thể trong mọi HTTP client: -H là header của request, -d là body, -X là phương thức, -u là basic auth, -F là một trường form multipart.
• Nếu curl thấy có body (-d, --data, -F) mà không có -X, nó mặc định dùng POST, cũng là mặc định của phần lớn client, nên khi không chỉ định -X thì đầu ra vẫn là POST.
• Body JSON khác với body form. Content-Type: application/json nghĩa là body được gửi nguyên văn; application/x-www-form-urlencoded nghĩa là các cặp khóa/giá trị được nối với nhau bằng &.
• -G chuyển body thành query string cho request GET. Đầu ra phản ánh điều đó: bạn sẽ thấy params / query được điền và không có body nào được gửi.

Cách chuyển curl sang code từng bước

1. 1

   Dán lệnh curl

   Thả toàn bộ lệnh, kể cả các ký tự nối dòng \ khi sao chép từ tài liệu, vào ô nhập. Bộ phân tích tự động chuẩn hóa dấu nháy cong và ký hiệu dấu nhắc của PowerShell.

2. 2

   Chọn ngôn ngữ đích

   Các tab gồm JavaScript fetch, TypeScript, Node axios, Python requests, Python httpx, Go, PHP, Ruby, Java HttpClient, C# HttpClient, HTTPie và PowerShell. Chuyển tab không tốn gì: việc phân tích chỉ chạy một lần.

3. 3

   Kiểm tra request đã phân tích

   Mở bảng *Request đã phân tích* để xác nhận phương thức, URL, header, loại body và các tùy chọn như insecure hay follow redirects đã được chuyển sang đúng như bạn mong đợi.

4. 4

   Sao chép và chỉnh phần xác thực

   Sao chép code được tạo vào dự án. Nếu lệnh curl có bearer token hoặc cookie, hãy thay giá trị cứng bằng biến môi trường trước khi commit.

Tra cứu nhanh các cờ cURL

Các cờ mà công cụ này hiểu và chúng tương ứng với gì trong code được tạo.

Ví dụ chuyển đổi cURL

curl 'https://api.example.com/v1/lessons?limit=20&track=python' \  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.demo'

const response = await fetch('https://api.example.com/v1/lessons?limit=20&track=python', {  method: 'GET',  headers: {    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiJ9.demo'  }});const data = await response.json();

curl 'https://api.example.com/v1/users' \  -H 'Content-Type: application/json' \  --data-raw '{"name":"Ada","age":36}'

import requests
headers = {    'Content-Type': 'application/json',}json_data = {"name":"Ada","age":36}
response = requests.post('https://api.example.com/v1/users', headers=headers, json=json_data)response.raise_for_status()

curl 'https://api.example.com/upload' \  -F 'caption=Hello' \  -F 'photo=@./avatar.jpg'

import requests
files = {    'caption': (None, 'Hello'),    'photo': open('./avatar.jpg', 'rb'),}
response = requests.post('https://api.example.com/upload', files=files)response.raise_for_status()

curl 'https://api.example.com/me' \  -u alice:s3cret \  -b 'session=2f9a; theme=dark'

const response = await fetch('https://api.example.com/me', {  method: 'GET',  headers: {    'Authorization': 'Basic YWxpY2U6czNjcmV0',    'Cookie': 'session=2f9a; theme=dark'  }});

Lỗi thường gặp khi chuyển đổi curl

• Dán lệnh curl có dấu nháy cong (', ', ", ") từ một bài blog. Trông chúng giống dấu nháy nhưng lại làm hỏng việc phân tích của shell. Công cụ có chuẩn hóa chúng, nhưng nếu được hãy sao chép lệnh gốc.
• Để lại -k (--insecure) trong production. Nó tắt việc xác minh chứng chỉ TLS: ổn khi phát triển cục bộ, nguy hiểm với lưu lượng thật.
• Quên rằng --data-raw và --data hoạt động khác nhau: --data mã hóa URL đầu vào. Dùng --data-raw cho body JSON có chứa @ hoặc &.
• Dán lệnh curl.exe của Windows mà không đổi ký tự nối dòng ^ thành \. Công cụ có xử lý việc này, nhưng bộ phân tích rất khắt khe với dấu nháy: hãy kiểm tra kỹ ranh giới các chuỗi.
• Sao chép bearer token hoặc cookie vào hệ thống quản lý phiên bản sau khi chuyển đổi. Hãy đổi chúng thành biến môi trường (process.env.API_TOKEN, os.environ['API_TOKEN']) trước khi commit.

Câu hỏi thường gặp về chuyển đổi cURL