Terminal indisponible

Ce que cela signifie

L’accès au terminal n’est pas configuré sur ce déploiement : l’URL du relais ou son secret de signature est absent, si bien qu’aucun ticket utilisable ne peut être émis.

L’API répond 503 plutôt que de renvoyer un ticket bien formé que rien n’accepterait. Un ticket signé sans secret paraît valide au client et est refusé par le relais, ce qui se manifeste par « le bouton fonctionne et le terminal ne s’ouvre jamais » : un problème bien plus difficile à diagnostiquer qu’un refus explicite.

Exemples de messages detail renvoyés avec cette erreur :

• Terminal access is not configured on this deployment.

Que faire

Rien à réessayer côté client. Sur les offres hébergées par fremforge, cela relève de nous : consultez status.frem.sh ou écrivez à support@frem.sh. Sur un déploiement auto-hébergé, l’URL du relais et le secret de signature doivent tous deux être présents.

Forme de la réponse

Toutes les erreurs de l’API fremforge sont au format problem+json de la RFC 9457 :

{
  "type": "https://docs.frem.sh/reference/api/errors/terminal-unavailable",
  "title": "Service Unavailable",
  "status": 503,
  "detail": "..."
}

Basez votre logique sur type, et non sur title ou detail : ces champs sont destinés à être lus par un humain et peuvent être reformulés.