Gitea icon

Gitea

Interact with Gitea via API

Actions393

Overview

This node interacts with the Gitea API to list badges associated with a specific user in an administrative context. It is useful for administrators who want to retrieve and manage user badges within a Gitea instance, such as displaying earned badges or verifying user achievements.

A practical example would be an admin dashboard that shows all badges awarded to a particular user by specifying their username, enabling quick access to user recognition data.

Properties

Name Meaning
Username The username of the user whose badges you want to list

Output

The node outputs JSON data containing the list of badges assigned to the specified user. Each badge entry typically includes details such as badge name, description, and possibly metadata like date awarded. The output structure aligns with the Gitea API response for user badges.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential for authenticating with the Gitea instance.
  • The node configuration must include the base URL of the Gitea server.
  • The node uses the Gitea REST API v1 endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing username parameter will cause the request to fail.
    • Incorrect or expired API credentials will result in authentication errors.
    • Network connectivity problems or incorrect base URL configuration can prevent successful API calls.
  • Error messages:

    • "Unauthorized" or "Authentication failed": Check that the API key credential is valid and has sufficient permissions.
    • "User not found": Verify that the username provided exists in the Gitea instance.
    • "Network error": Confirm the Gitea server URL is correct and reachable.

Links and References

Discussion