Blagues API icon

Blagues API

Récupère des blagues françaises depuis Blagues API. Opérations disponibles: getRandom (aléatoire, exclure catégories), getRandomCategorized (aléatoire par catégorie), getById (par ID), getCount (nombre total).

Actions3

Get Joke by ID

AI-generated

Overview

This node integrates with the "Blagues API" to retrieve French jokes. It supports multiple operations such as fetching a random joke, fetching a random joke by category, retrieving a joke by its numeric ID, and getting the total count of jokes available. This node is useful for applications that want to add humor content dynamically, such as chatbots, social media posts, or entertainment apps.

For the Get Joke by ID operation specifically, the node fetches a single joke based on a provided numeric identifier. This is beneficial when you want to retrieve a specific joke known by its ID, for example, to display a particular joke stored or referenced elsewhere.

Properties

Name Meaning
Joke ID Numeric identifier of the joke to retrieve. Required for the "Get Joke by ID" operation.

Output

The output JSON contains the joke data retrieved from the API corresponding to the requested joke ID. The structure typically includes fields describing the joke text and possibly metadata (not explicitly detailed in the source). If multiple items are processed, each will have its own output object.

No binary data output is indicated by the code.

Dependencies

  • Requires an API key credential for the Blagues API service.
  • Uses the external blagues-api npm package to interact with the API.
  • Requires proper configuration of the API key credential within n8n.

Troubleshooting

  • Missing API Token: If the API key credential is not set or missing, the node throws an error indicating the absence of the API token. Ensure the API key is configured correctly in the node credentials.
  • Invalid Joke ID: If the Joke ID parameter is missing or invalid (e.g., null), the node throws an error stating that the Joke ID is required.
  • Unknown Operation: If an unsupported operation is selected, the node throws an error about the unknown operation.
  • API Errors: Any errors returned by the external API (e.g., joke not found) will be surfaced as execution errors.
  • To handle failures gracefully, enable "Continue On Fail" in the node settings to receive error details in the output instead of stopping execution.

Links and References

Discussion