Zum Hauptinhalt springen

channel_not_found

HTTP 404 · code: "channel_not_found" · type: https://docs.formfeed.dev/errors/channel-not-found

Die Anfrage nennt einen Release Channel, den die Vorlage im Workspace des Schlüssels nicht hat. Bei einem Rendering wiederholen template und channel, was die Anfrage genannt hat.

Beispiel​

{
  "type": "https://docs.formfeed.dev/errors/channel-not-found",
  "title": "Channel not found",
  "status": 404,
  "detail": "Template \"invoice\" has no channel \"staging\" in workspace production",
  "code": "channel_not_found",
  "template": "invoice",
  "channel": "staging",
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Häufige Ursachen​

  • Ein Rendering oder Batch-Element mit "version": "staging" für eine Vorlage ohne Channel staging, etwa weil er in diesem Workspace nie angelegt oder gelöscht wurde.
  • GET /templates/{id}/versions/{channel} für einen solchen Channel; das liest auch formfeed types --channel.
  • promote, rollback oder DELETE für einen Channel, den es nicht gibt.
  • Ein falsch geschriebener Channel-Name, etwa stagging.

Eine Vorlage ohne die Version, die ein Rendering nennt, antwortet stattdessen mit template_not_found. Ein Name, der gar kein Channel sein kann (Großbuchstaben, eine führende Ziffer, mehr als 32 Zeichen), antwortet bei Renderings und beim Lesen von Versionen mit invalid_request und bei den Channel-Endpunkten mit channel_name_invalid. Im Free-Plan antwortet ein Rendering oder ein PUT, das einen anderen Channel als published nennt, mit forbidden (feature: "channels"), bevor der Channel gesucht wird.

So beheben Sie es​

  • Listen Sie die Channels der Vorlage mit formfeed channels list <slug> oder GET /templates/{id}/channels auf.
  • Legen Sie den Channel an (formfeed channels set <slug> staging <version>) oder rendern Sie einen anderen. Siehe Release Channels.
  • Prüfen Sie, ob der Schlüssel zum erwarteten Workspace gehört: Channels gehören zu einer Vorlage, und Vorlagen zu einem Workspace.

Wiederholen?​

Nein. Dieselbe Anfrage erhält dieselbe Antwort. Beheben Sie, was das Problem nennt, und senden Sie die Anfrage dann mit einem neuen Idempotency-Key oder ohne: Eine 4xx-Antwort wird 24 Stunden unter ihrem Schlüssel gespeichert, der alte Schlüssel liefert also wieder dieses Problem. Siehe Wiederholen.