smtp_unreachable

HTTP status: 502 · Code: smtp_unreachable

The SMTP server could not be reached: the name did not resolve, or the connection was refused or reset.

Why it happens

Orvano could not reach the SMTP server: the host name didn’t resolve, or the connection was refused or reset.

How to fix

Check the host and port. Common ports are 587 (STARTTLS), 465 (TLS), and 25 (plain). Check that your server allows outgoing connections on that port; many cloud providers block port 25.

Catch it in your code

Every SDK throws one error type for a failed call. Match on its code, which is always smtp_unreachable for this error, never on the message.

JavaScript and Next.js

import { ErrorCode, OrvanoError } from '@orvano/js'

try {
  // your Orvano call
} catch (error) {
  if (error instanceof OrvanoError && error.code === ErrorCode.smtpUnreachable) {
    // handle smtp_unreachable
  } else {
    throw error
  }
}

Dart and Flutter

import 'package:orvano_flutter/orvano_flutter.dart'; // or orvano_dart on a server

try {
  // your Orvano call
} on OrvanoException catch (error) {
  if (error.code != ErrorCode.smtpUnreachable) rethrow;
  // handle smtp_unreachable
}

.NET

using Orvano;

try
{
    // your Orvano call
}
catch (OrvanoException error) when (error.Code == ErrorCode.SmtpUnreachable)
{
    // handle smtp_unreachable
}

The error also carries the HTTP status (502), a message, and a request ID. Quote the request ID when you report a problem: the server logs it with the failure. See Errors for how errors work in every SDK, or every error code.