Skip to content
Snippets Groups Projects
index.mdx 1.54 KiB
Newer Older
Sebastian Kawelke's avatar
Sebastian Kawelke committed
---
sidebar_position: 1
---

Sebastian Kawelke's avatar
Sebastian Kawelke committed
# Overview

<div className="flex justify-center"><img src="/assets/badges/badges-overview.svg" className="h-96"/></div>
Sebastian Kawelke's avatar
Sebastian Kawelke committed

### Fundamentals

The Badge API is a service scanning repositories for specific criteria and generating badges based on the results. 
The badges are displayed in the Open CoDE software catalog and indicate the status of the repository in terms of 
**security**, **maintenance**, and **reuse**.

Each badge is based on a set of criteria that the repository must meet to receive the badge. Actively
The criteria are divided into three levels: **Bronze**, **Silver**, and **Gold**, respectively 
**Ready for Reuse** and **Actively Reused** for the reuse badge.
The higher the level, the more criteria the repository must meet.

All criteria are evaluated bluntly like a checklist and must therefore lead to a true or false result. 
As a result, some checks are evaluated based on thresholds (e.g. the issue reaction time). 
To determine the thresholds, we examine the usual values of the projects on Open CoDE and derive 
the corresponding thresholds from their mean values and standard deviations. 

Many checks are evaluated relative to a timeframe. Unless explicitly stated "timeframe" refers to now - 30 days.

### Explanation

We encourage that you integrate the [badge explanation endpoint](/api-docs/v1/badges#get-badge-explanation) 
into your application to provide a detailed explanation of the badge result to your users.

A typical use case is to make the badge clickable and show the explanation on a detail page.

Consent

On this website, we use the web analytics service Matomo to analyze and review the use of our website. Through the collected statistics, we can improve our offerings and make them more appealing for you. Here, you can decide whether to allow us to process your data and set corresponding cookies for these purposes, in addition to technically necessary cookies. Further information on data protection—especially regarding "cookies" and "Matomo"—can be found in our privacy policy. You can withdraw your consent at any time.