Como enviar e-mails com Kotlin

Envie e-mails do Kotlin (Android/servidor) com o cliente `OkHttp`.

Não há SDK oficial — chame a API REST do Publiq com o cliente HTTP da linguagem, a partir do servidor, com a API key no 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 { }
}

Boas práticas

  • Chame o Publiq sempre do servidor — nunca exponha a API key no cliente.
  • Crie a instância do cliente uma vez e reutilize-a entre requisições.
  • Prefira templateKey a HTML inline para manter o conteúdo versionado.
  • Trate PubliqError (status/code); o SDK já retenta erros temporários com backoff.
  • Envie de um domínio verificado — veja Domínios.

Veja também

Como enviar e-mails com Kotlin — Publiq Docs