تبدیل curl به Kotlin

Q: Kotlin OkHttp چیست؟

OkHttp یک کلاینت HTTP پرکاربرد برای Kotlin و Java است که توسط Square توسعه یافته است. این کتابخانه دارای قابلیتهایی مانند connection pooling، GZIP شفاف، کشینگ پاسخ و پشتیبانی از HTTP/2 است. با implementation("com.squareup.okhttp3:okhttp:4.x") آن را اضافه کنید. این کتابخانه پیشفرضی است که curl2code برای تبدیلهای Kotlin استفاده میکند و کلاینت استاندارد HTTP برای Android است.

Q: OkHttp در مقابل Ktor Client در مقابل Fuel — از کدام استفاده کنیم؟

OkHttp استاندارد صنعت است، به ویژه برای Android. Ktor Client اولویت را به Kotlin میدهد و از coroutine و قابلیتهای چند پلتفرمی پشتیبانی میکند. Fuel سبکوزن با یک DSL تمیز برای Kotlin است. برای Android، OkHttp (اغلب از طریق Retrofit) انتخاب پیشفرض است. برای مقایسه JVM، مبدل curl به Java ما را ببینید.

Q: چگونه احراز هویت را در Kotlin مدیریت کنیم؟

یک هدر اضافه کنید: request.addHeader("Authorization", "Bearer $token"). برای احراز هویت Basic: از ابزار Credentials.basic(user, pass) استفاده کنید. OkHttp همچنین از اینترفیس Authenticator برای تلاش مجدد خودکار با اعتبارنامهها در پاسخهای 401 پشتیبانی میکند. curl2code پرچمهای -u و Bearer را به طور خودکار مدیریت میکند.

Q: چگونه دادههای multipart form را در Kotlin ارسال کنیم؟

از MultipartBody.Builder() در OkHttp استفاده کنید: .addFormDataPart("file", filename, fileBody) برای فایلها و .addFormDataPart("key", "value") برای فیلدها. .setType(MultipartBody.FORM) را تنظیم کنید. curl2code پرچمهای -F را به کد صحیح سازنده multipart در OkHttp تبدیل میکند.

Q: چگونه خطاهای HTTP را در Kotlin مدیریت کنیم؟

برای وضعیت 2xx مقدار response.isSuccessful را بررسی کنید یا response.code را بخوانید. OkHttp در صورت شکست شبکه IOException پرتاب میکند. از runCatching { } کاتلین یا try/catch برای مدیریت خطای تمیز استفاده کنید. همیشه بدنه پاسخ را با بلوک .use { } ببندید تا از نشت منابع جلوگیری شود.

Q: چگونه از coroutines با OkHttp استفاده کنیم؟

فراخوانیهای مسدودکننده OkHttp را در withContext(Dispatchers.IO) { client.newCall(request).execute() } قرار دهید. یا از اکستنشن suspendCancellableCoroutine با enqueue() برای حالت واقعاً ناهمزمان استفاده کنید. Ktor Client دارای پشتیبانی بومی از coroutine است. برای الگوهای ناهمزمان مشابه، curl به Swift (async/await) را ببینید.

Q: چگونه تایماوتها را در Kotlin OkHttp تنظیم کنیم؟

روی کلاینت پیکربندی کنید: OkHttpClient.Builder().connectTimeout(10, TimeUnit.SECONDS).readTimeout(30, TimeUnit.SECONDS).writeTimeout(30, TimeUnit.SECONDS).build(). برای تلاش مجدد، یک interceptor اضافه کنید که در صورت شکست دوباره تلاش کند. اینها با --connect-timeout و --max-time در curl مطابقت دارند.

Q: چگونه از یک پروکسی با OkHttp استفاده کنیم؟

در سازنده کلاینت تنظیم کنید: OkHttpClient.Builder().proxy(Proxy(Proxy.Type.HTTP, InetSocketAddress("proxy", 8080))).build(). برای احراز هویت، proxyAuthenticator را اضافه کنید. OkHttp همچنین از پروکسیهای SOCKS با Proxy.Type.SOCKS پشتیبانی میکند. curl2code پرچمهای -x را به این پیکربندی تبدیل میکند.

Q: چگونه یک درخواست POST با بدنه JSON در Kotlin ارسال کنیم؟

یک دستور curl POST مانند curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL را با استفاده از curl2code به Kotlin تبدیل کنید. کد تولید شده از RequestBody.create(MediaType.parse("application/json"), json) استفاده میکند. curl2code به طور خودکار فلگهای -d/--data با محتوای JSON را تشخیص داده و هدر Content-Type مناسب را در کد OkHttp تنظیم میکند.

Q: چگونه احراز هویت با Bearer token را در Kotlin اضافه کنیم؟

دستور curl -H "Authorization: Bearer YOUR_TOKEN" URL را به curl2code بدهید تا کد OkHttp را با هدر احراز هویت تولید کند: .addHeader("Authorization", "Bearer YOUR_TOKEN"). curl2code توکنهای Bearer را از هر دو فلگ -H "Authorization: Bearer ..." و --oauth2-bearer تشخیص میدهد. برای Basic auth، از -u user:pass استفاده کنید.

curl2code دستورات curl را با استفاده از OkHttp به کد Kotlin تبدیل می‌کند. این تبدیل برای حفظ حریم خصوصی کامل، در مرورگر شما از طریق WebAssembly انجام می‌شود. برای Java، مبدل curl به Java ما را بررسی کنید. برای Swift (iOS)، curl به Swift را ببینید. در ادامه مثال‌های کاربردی Kotlin آورده شده است.

نحوه کپی کردن curl از مرورگر

1
باز کردن DevTools
کلید F12 یا Ctrl+Shift+I را فشار دهید تا ابزارهای توسعه‌دهنده مرورگر باز شوند.
2
رفتن به تب Network
روی تب Network کلیک کنید و عملیاتی که باعث ارسال درخواست HTTP می‌شود را انجام دهید.
3
کپی به عنوان cURL
روی درخواست راست‌کلیک کنید ← Copy ← Copy as cURL. سپس آن را در بالا جایگذاری کنید.

مثال‌های کد Kotlin

1درخواست GET ساده

دستور curl

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

Kotlin · OkHttp

import java.io.IOException
import okhttp3.OkHttpClient
import okhttp3.Request

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.example.com/users")
  .build()

client.newCall(request).execute().use { response ->
  if (!response.isSuccessful) throw IOException("Unexpected code $response")
  response.body!!.string()
}

2POST با بدنه JSON

دستور curl

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

Kotlin · OkHttp

import java.io.IOException
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody

val client = OkHttpClient()

val MEDIA_TYPE = "application/json".toMediaType()

val requestBody = "{\"name\":\"John\",\"email\":\"john@example.com\"}"

val request = Request.Builder()
  .url("https://api.example.com/users")
  .post(requestBody.toRequestBody(MEDIA_TYPE))
  .header("Content-Type", "application/json")
  .build()

client.newCall(request).execute().use { response ->
  if (!response.isSuccessful) throw IOException("Unexpected code $response")
  response.body!!.string()
}

3درخواست با Bearer Token

دستور curl

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

Kotlin · OkHttp

import java.io.IOException
import okhttp3.OkHttpClient
import okhttp3.Request

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.example.com/me")
  .header("Authorization", "Bearer token123")
  .build()

client.newCall(request).execute().use { response ->
  if (!response.isSuccessful) throw IOException("Unexpected code $response")
  response.body!!.string()
}

4آپلود فرم Multipart

دستور curl

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

Kotlin · OkHttp

import java.io.File
import java.io.IOException
import okhttp3.MultipartBody
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody.Companion.asRequestBody

val client = OkHttpClient()

val requestBody = MultipartBody.Builder()
  .setType(MultipartBody.FORM)
  .addFormDataPart("file", "document.pdf", File("document.pdf").asRequestBody())
  .addFormDataPart("description", "My file")
  .build()

val request = Request.Builder()
  .url("https://api.example.com/upload")
  .post(requestBody)
  .build()

client.newCall(request).execute().use { response ->
  if (!response.isSuccessful) throw IOException("Unexpected code $response")
  response.body!!.string()
}

5هدرهای سفارشی

دستور curl

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

Kotlin · OkHttp

import java.io.IOException
import okhttp3.OkHttpClient
import okhttp3.Request

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.example.com/data")
  .header("X-API-Key", "abc123")
  .header("Accept", "application/json")
  .header("X-Request-ID", "req-456")
  .build()

client.newCall(request).execute().use { response ->
  if (!response.isSuccessful) throw IOException("Unexpected code $response")
  response.body!!.string()
}

سوالات متداول

Kotlin OkHttp چیست؟

OkHttp یک کلاینت HTTP پرکاربرد برای Kotlin و Java است که توسط Square توسعه یافته است. این کتابخانه دارای قابلیت‌هایی مانند connection pooling، GZIP شفاف، کشینگ پاسخ و پشتیبانی از HTTP/2 است. با implementation("com.squareup.okhttp3:okhttp:4.x") آن را اضافه کنید. این کتابخانه پیش‌فرضی است که curl2code برای تبدیل‌های Kotlin استفاده می‌کند و کلاینت استاندارد HTTP برای Android است.

OkHttp در مقابل Ktor Client در مقابل Fuel — از کدام استفاده کنیم؟

OkHttp استاندارد صنعت است، به ویژه برای Android. Ktor Client اولویت را به Kotlin می‌دهد و از coroutine و قابلیت‌های چند پلتفرمی پشتیبانی می‌کند. Fuel سبک‌وزن با یک DSL تمیز برای Kotlin است. برای Android، OkHttp (اغلب از طریق Retrofit) انتخاب پیش‌فرض است. برای مقایسه JVM، مبدل curl به Java ما را ببینید.

چگونه احراز هویت را در Kotlin مدیریت کنیم؟

یک هدر اضافه کنید: request.addHeader("Authorization", "Bearer $token"). برای احراز هویت Basic: از ابزار Credentials.basic(user, pass) استفاده کنید. OkHttp همچنین از اینترفیس Authenticator برای تلاش مجدد خودکار با اعتبارنامه‌ها در پاسخ‌های 401 پشتیبانی می‌کند. curl2code پرچم‌های -u و Bearer را به طور خودکار مدیریت می‌کند.

چگونه داده‌های multipart form را در Kotlin ارسال کنیم؟

از MultipartBody.Builder() در OkHttp استفاده کنید: .addFormDataPart("file", filename, fileBody) برای فایل‌ها و .addFormDataPart("key", "value") برای فیلدها. .setType(MultipartBody.FORM) را تنظیم کنید. curl2code پرچم‌های -F را به کد صحیح سازنده multipart در OkHttp تبدیل می‌کند.

چگونه خطاهای HTTP را در Kotlin مدیریت کنیم؟

برای وضعیت 2xx مقدار response.isSuccessful را بررسی کنید یا response.code را بخوانید. OkHttp در صورت شکست شبکه IOException پرتاب می‌کند. از runCatching { } کاتلین یا try/catch برای مدیریت خطای تمیز استفاده کنید. همیشه بدنه پاسخ را با بلوک .use { } ببندید تا از نشت منابع جلوگیری شود.

چگونه از coroutines با OkHttp استفاده کنیم؟

فراخوانی‌های مسدودکننده OkHttp را در withContext(Dispatchers.IO) { client.newCall(request).execute() } قرار دهید. یا از اکستنشن suspendCancellableCoroutine با enqueue() برای حالت واقعاً ناهمزمان استفاده کنید. Ktor Client دارای پشتیبانی بومی از coroutine است. برای الگوهای ناهمزمان مشابه، curl به Swift (async/await) را ببینید.

چگونه تایم‌اوت‌ها را در Kotlin OkHttp تنظیم کنیم؟

روی کلاینت پیکربندی کنید: OkHttpClient.Builder().connectTimeout(10, TimeUnit.SECONDS).readTimeout(30, TimeUnit.SECONDS).writeTimeout(30, TimeUnit.SECONDS).build(). برای تلاش مجدد، یک interceptor اضافه کنید که در صورت شکست دوباره تلاش کند. این‌ها با --connect-timeout و --max-time در curl مطابقت دارند.

چگونه از یک پروکسی با OkHttp استفاده کنیم؟

در سازنده کلاینت تنظیم کنید: OkHttpClient.Builder().proxy(Proxy(Proxy.Type.HTTP, InetSocketAddress("proxy", 8080))).build(). برای احراز هویت، proxyAuthenticator را اضافه کنید. OkHttp همچنین از پروکسی‌های SOCKS با Proxy.Type.SOCKS پشتیبانی می‌کند. curl2code پرچم‌های -x را به این پیکربندی تبدیل می‌کند.

چگونه یک درخواست POST با بدنه JSON در Kotlin ارسال کنیم؟

یک دستور curl POST مانند curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL را با استفاده از curl2code به Kotlin تبدیل کنید. کد تولید شده از RequestBody.create(MediaType.parse("application/json"), json) استفاده می‌کند. curl2code به طور خودکار فلگ‌های -d/--data با محتوای JSON را تشخیص داده و هدر Content-Type مناسب را در کد OkHttp تنظیم می‌کند.

چگونه احراز هویت با Bearer token را در Kotlin اضافه کنیم؟

دستور curl -H "Authorization: Bearer YOUR_TOKEN" URL را به curl2code بدهید تا کد OkHttp را با هدر احراز هویت تولید کند: .addHeader("Authorization", "Bearer YOUR_TOKEN"). curl2code توکن‌های Bearer را از هر دو فلگ -H "Authorization: Bearer ..." و --oauth2-bearer تشخیص می‌دهد. برای Basic auth، از -u user:pass استفاده کنید.

چگونه هدر Content-Type را در Kotlin تنظیم کنیم؟

curl2code دستور curl -H "Content-Type: application/json" URL را به کد OkHttp با هدر مناسب تبدیل می‌کند: .addHeader("Content-Type", "application/json"). برای داده‌های -d، دستور curl به طور پیش‌فرض از application/x-www-form-urlencoded استفاده می‌کند؛ برای آپلودهای فرم -F، از multipart/form-data استفاده می‌کند. curl2code هر کدام را به API صحیح OkHttp نگاشت می‌کند.

لینک‌های مفید

مستندات OkHttp

square.github.io

مرجع کتابخانه استاندارد

ktor.io

صفحه راهنمای curl

curl.se

راهنماهای curl

کدهای خطای curl

هر کد خروجی curl را جستجو کنید — دلایل، راه‌حل‌ها و نکات رفع اشکال.

دانلود فایل‌ها با curl

فایل‌ها را با -o و -O ذخیره کنید، ریدایرکت‌ها را دنبال کنید، دانلودها را از سر بگیرید و موارد بیشتر.

SSL، TLS و پروکسی

گواهی‌ها، نسخه‌های TLS، پروکسی‌های HTTP/SOCKS و DNS سفارشی را پیکربندی کنید.

نحوه کپی کردن curl از مرورگر

مثال‌های کد Kotlin

1درخواست GET ساده

2POST با بدنه JSON

3درخواست با Bearer Token

4آپلود فرم Multipart

5هدرهای سفارشی

سوالات متداول

لینک‌های مفید

راهنماهای curl

تبدیل curl به زبان‌های دیگر

مثال‌های کد Kotlin

1درخواست GET ساده

2POST با بدنه JSON

3درخواست با Bearer Token

4آپلود فرم Multipart

5هدرهای سفارشی