Cómo enviar correos con Kotlin

Envía correos desde Kotlin (Android/servidor) con el cliente `OkHttp`.

No hay SDK oficial — llama a la API REST de Publiq con el cliente HTTP del lenguaje, desde el servidor, con la API key en el header Authorization.

import okhttp3.*
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody

fun sendWelcome(to: String) {
    val client = OkHttpClient()
    val json = """{"from":"you@yourdomain.com","to":"$to","templateKey":"welcome-email"}"""
    val request = Request.Builder()
        .url("https://api.publiq.digital/v1/emails")
        .header("Authorization", "Bearer ${System.getenv("PUBLIQ_API_KEY")}")
        .post(json.toRequestBody("application/json".toMediaType()))
        .build()
    client.newCall(request).execute().use { }
}

Buenas prácticas

  • Llama a Publiq siempre desde el servidor — nunca expongas la API key en el cliente.
  • Crea la instancia del cliente una vez y reutilízala entre peticiones.
  • Prefiere templateKey sobre HTML inline para mantener el contenido versionado.
  • Maneja PubliqError (status/code); el SDK ya reintenta errores transitorios con backoff.
  • Envía desde un dominio verificado — ver Dominios.

Ver también

Cómo enviar correos con Kotlin — Publiq Docs