للاتصال بواجهات برمجة التطبيقات (APIs) من خلال الكوتلن، يمكنك استخدام مكتبات مثل Retrofit أو Volley. في هذا المثال، سنستخدم Retrofit.
1. إضافة Retrofit إلى ملف “build.gradle” الخاص بمشروعك:
“`kotlin
implementation ‘com.squareup.retrofit2:retrofit:2.9.0’
implementation ‘com.squareup.retrofit2:converter-gson:2.9.0’
“`
2. إنشاء نموذج (Model) يمثل البيانات التي ستتلقاها من الواجهة:
“`kotlin
data class User(
val id: Int,
val name: String,
val email: String
)
“`
3. إنشاء واجهة تعريف الواجهة البرمجية (API interface) باستخدام الأنواع المناسبة والأشكال:
“`kotlin
interface ApiService {
@GET(“users”)
suspend fun getUsers(): List
}
“`
4. إنشاء كائن Retrofit وتكوينه مع قاعدة URL ومحول (converter) لتحويل البيانات إلى نموذج (Model):
“`kotlin
val retrofit = Retrofit.Builder()
.baseUrl(“https://api.example.com/”)
.addConverterFactory(GsonConverterFactory.create())
.build()
val apiService = retrofit.create(ApiService::class.java)
“`
5. استدعاء الدالة المناسبة في واجهة الواجهة البرمجية (API interface) باستخدام Coroutine:
“`kotlin
lifecycleScope.launch {
try {
val users = apiService.getUsers()
for (user in users) {
Log.d(“API”, “User: ${user.name}”)
}
} catch (e: Exception) {
Log.e(“API”, “Error: ${e.message}”)
}
}
“`
هذا مثال بسيط على كيفية الاتصال بواجهة برمجة التطبيقات (API) باستخدام Retrofit في الكوتلن. يمكن تعديله وتخصيصه حسب احتياجاتك الخاصة.