Laravel’s HTTP client makes the API a few lines of code. Render your content with Blade, and send from a queued job.
Configuration
# .env
ROBUSTEMAIL_API_KEY=rb_test_...
// config/services.php
'robustemail' => [
'key' => env('ROBUSTEMAIL_API_KEY'),
'url' => 'https://robustemail.com/api/v2',
],
A small service
<?php
namespace App\Services;
use Illuminate\Support\Facades\Http;
class RobustEmail
{
public function send(array $email, ?string $idempotencyKey = null): string
{
$request = Http::withToken(config('services.robustemail.key'))
->acceptJson()
->timeout(15);
if ($idempotencyKey) {
$request = $request->withHeaders(['Idempotency-Key' => $idempotencyKey]);
}
return $request->post(config('services.robustemail.url') . '/emails', $email)
->throw()
->json('id');
}
}
Send from a queued job
<?php
namespace App\Jobs;
use App\Models\Order;
use App\Services\RobustEmail;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
class SendOrderConfirmation implements ShouldQueue
{
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
public $tries = 5;
public $backoff = [10, 30, 60, 120];
public function __construct(public Order $order)
{
}
public function handle(RobustEmail $mail): void
{
$mail->send([
'from' => 'Acme <orders@acme.com>',
'to' => $this->order->customer_email,
'subject' => "Order #{$this->order->number} confirmed",
'html' => view('emails.order-confirmed', ['order' => $this->order])->render(),
], "order-{$this->order->id}-confirmation");
}
}
Because every retry of the job uses the same idempotency key, a job that timed out after the email was accepted never sends a second copy.
SendOrderConfirmation::dispatch($order);