محول Curl إلى Ruby

أوامر curl الشائعة لاختبار API في Ruby

فيما يلي بعض أوامر curl الشائعة التي يمكنك تحويلها إلى كود Ruby:

• Basic GET request: curl https://api.example.com/users
• POST with JSON data: curl -X POST -H "Content-Type: application/json" -d '{"name":"John","email":"[email protected]"}' https://api.example.com/users
• PUT with authentication: curl -X PUT -H "Authorization: Bearer token123" -d '{"status":"active"}' https://api.example.com/users/1
• DELETE request: curl -X DELETE https://api.example.com/users/1
• Custom headers: curl -H "X-API-Key: abc123" -H "Accept: application/json" https://api.example.com/data

أمثلة Ruby Net::HTTP

مكتبة Ruby's Net::HTTP هي طريقة قوية لإجراء طلبات HTTP. فيما يلي بعض أنماط Ruby Net::HTTP الشائعة:

تحميل الملفات باستخدام Ruby Net::HTTP

require 'net/http'
require 'uri'

uri = URI.parse('https://api.example.com/upload')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true if uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Authorization'] = 'Bearer YOUR_TOKEN_HERE'

# Create multipart form data
boundary = "AaB03x"
post_body = []
post_body << "--#{boundary}\r\n"
post_body << "Content-Disposition: form-data; name=\"file\"; filename=\"document.pdf\"\r\n"
post_body << "Content-Type: application/pdf\r\n\r\n"
post_body << File.read('document.pdf')
post_body << "\r\n--#{boundary}--\r\n"

request['Content-Type'] = "multipart/form-data; boundary=#{boundary}"
request.body = post_body.join

response = http.request(request)
puts response.body

Ruby Net::HTTP with Timeout and Error Handling

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://api.example.com/data')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true if uri.scheme == 'https'
http.open_timeout = 5  # seconds
http.read_timeout = 5  # seconds

begin
  request = Net::HTTP::Get.new(uri.request_uri)
  response = http.request(request)
  
  case response
  when Net::HTTPSuccess
    data = JSON.parse(response.body)
    puts data
  else
    puts "Error: #{response.code} - #{response.message}"
  end
rescue Net::OpenTimeout
  puts "Connection timed out"
rescue Net::ReadTimeout
  puts "Response timed out"
rescue StandardError => e
  puts "Error making request: #{e.message}"
end

مرجع أوامر Curl لاختبار API في Ruby

فهم أوامر curl ضروري لاختبار API الفعال مع Ruby. إليك مرجعاً سريعاً لخيارات curl الشائعة التي يدعمها محولنا:

بناء جملة curl الأساسي

curl [options] [URL]

خيارات curl الشائعة

• -X, --request METHOD: Specify request method (GET, POST, PUT, DELETE, etc.)
• -H, --header LINE: Add header to the request
• -d, --data DATA: Send data in POST request
• -F, --form CONTENT: Submit form data
• -u, --user USER:PASSWORD: Server user and password
• -k, --insecure: Allow insecure server connections
• -I, --head: Show document info only
• -v, --verbose: Make the operation more verbose
• -s, --silent: Silent mode
• --connect-timeout SECONDS: Maximum time for connection

تحويل أوامر curl المعقدة

يتعامل محول Ruby لدينا مع أوامر curl المعقدة بما في ذلك الرؤوس المتعددة والمصادقة وحمولات البيانات والخيارات المختلفة. ما عليك سوى لصق أمر curl الخاص بك والحصول على كود Ruby نظيف وحديث باستخدام مكتبة Net::HTTP.

أفضل ممارسات Ruby Net::HTTP

عند العمل مع مكتبة Ruby Net::HTTP، اتبع أفضل الممارسات التالية للتفاعلات الفعالة والآمنة مع API:

1. استخدام تجمع اتصالات للطلبات المتعددة

require 'net/http'
require 'uri'

uri = URI.parse('https://api.example.com')
Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') do |http|
  # First request
  request1 = Net::HTTP::Get.new('/users')
  response1 = http.request(request1)
  
  # Second request (uses same connection)
  request2 = Net::HTTP::Get.new('/products')
  response2 = http.request(request2)
end

2. Implement Proper Error Handling

require 'net/http'
require 'uri'

uri = URI.parse('https://api.example.com/data')
begin
  response = Net::HTTP.get_response(uri)
  
  case response
  when Net::HTTPSuccess
    puts "Success: #{response.body}"
  when Net::HTTPRedirection
    puts "Redirection to: #{response['location']}"
  when Net::HTTPClientError
    puts "Client error: #{response.code} - #{response.message}"
  when Net::HTTPServerError
    puts "Server error: #{response.code} - #{response.message}"
  else
    puts "Unknown response: #{response.code} - #{response.message}"
  end
rescue SocketError => e
  puts "Connection error: #{e.message}"
rescue Timeout::Error
  puts "Connection timed out"
rescue StandardError => e
  puts "Error: #{e.message}"
end

3. استخدام JSON بأمان

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://api.example.com/data')
response = Net::HTTP.get_response(uri)

begin
  data = JSON.parse(response.body)
  puts data['name']
rescue JSON::ParserError => e
  puts "Invalid JSON response: #{e.message}"
end