TYPO3 Badges
A beautiful eye-catcher for your extension documentations.
🚀 Usage
This API provides endpoints for Badgen and Shields.io, allowing badges to be rendered.
Each endpoint supports the
svg
format with the rendered SVG badge and the
json
format with JSON data for external badge providers.
🔥 Endpoints
-
GET
Get JSON data for Composer name./badge/{extension}/composer/{provider}.{_format}
-
GET
Get JSON data for total extension downloads./badge/{extension}/downloads/{provider}.{_format}
![Total downloads](https://typo3-badges.dev/badge/static_info_tables_taxes/downloads/badgen.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/downloads/badgen.svg
:alt: Total downloads<img alt="Total downloads" src="https://typo3-badges.dev/badge/static_info_tables_taxes/downloads/badgen.svg">
![Total downloads](https://typo3-badges.dev/badge/static_info_tables_taxes/downloads/shields.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/downloads/shields.svg
:alt: Total downloads<img alt="Total downloads" src="https://typo3-badges.dev/badge/static_info_tables_taxes/downloads/shields.svg">
-
GET
Get JSON data for extension key./badge/{extension}/extension/{provider}.{_format}
![TYPO3 extension](https://typo3-badges.dev/badge/static_info_tables_taxes/extension/badgen.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/extension/badgen.svg
:alt: TYPO3 extension<img alt="TYPO3 extension" src="https://typo3-badges.dev/badge/static_info_tables_taxes/extension/badgen.svg">
![TYPO3 extension](https://typo3-badges.dev/badge/static_info_tables_taxes/extension/shields.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/extension/shields.svg
:alt: TYPO3 extension<img alt="TYPO3 extension" src="https://typo3-badges.dev/badge/static_info_tables_taxes/extension/shields.svg">
-
GET
Get JSON data for extension stability./badge/{extension}/stability/{provider}.{_format}
![Stability](https://typo3-badges.dev/badge/static_info_tables_taxes/stability/badgen.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/stability/badgen.svg
:alt: Stability<img alt="Stability" src="https://typo3-badges.dev/badge/static_info_tables_taxes/stability/badgen.svg">
![Stability](https://typo3-badges.dev/badge/static_info_tables_taxes/stability/shields.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/stability/shields.svg
:alt: Stability<img alt="Stability" src="https://typo3-badges.dev/badge/static_info_tables_taxes/stability/shields.svg">
-
GET
Get JSON data for supported TYPO3 versions./badge/{extension}/typo3/{provider}.{_format}
![TYPO3 versions](https://typo3-badges.dev/badge/static_info_tables_taxes/typo3/badgen.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/typo3/badgen.svg
:alt: TYPO3 versions<img alt="TYPO3 versions" src="https://typo3-badges.dev/badge/static_info_tables_taxes/typo3/badgen.svg">
![TYPO3 versions](https://typo3-badges.dev/badge/static_info_tables_taxes/typo3/shields.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/typo3/shields.svg
:alt: TYPO3 versions<img alt="TYPO3 versions" src="https://typo3-badges.dev/badge/static_info_tables_taxes/typo3/shields.svg">
-
GET
Get JSON data for extension verification state./badge/{extension}/verified/{provider}.{_format}
![Verified state](https://typo3-badges.dev/badge/static_info_tables_taxes/verified/badgen.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/verified/badgen.svg
:alt: Verified state<img alt="Verified state" src="https://typo3-badges.dev/badge/static_info_tables_taxes/verified/badgen.svg">
![Verified state](https://typo3-badges.dev/badge/static_info_tables_taxes/verified/shields.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/verified/shields.svg
:alt: Verified state<img alt="Verified state" src="https://typo3-badges.dev/badge/static_info_tables_taxes/verified/shields.svg">
-
GET
Get JSON data for current extension version./badge/{extension}/version/{provider}.{_format}
![Latest version](https://typo3-badges.dev/badge/static_info_tables_taxes/version/badgen.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/version/badgen.svg
:alt: Latest version<img alt="Latest version" src="https://typo3-badges.dev/badge/static_info_tables_taxes/version/badgen.svg">
![Latest version](https://typo3-badges.dev/badge/static_info_tables_taxes/version/shields.svg)
.. image:: https://typo3-badges.dev/badge/static_info_tables_taxes/version/shields.svg
:alt: Latest version<img alt="Latest version" src="https://typo3-badges.dev/badge/static_info_tables_taxes/version/shields.svg">
🤖 JSON response schema
All JSON endpoints return objects to be processed by Badgen.
{
"subject": "typo3",
"status": "inspiring people to share",
"color": "orange"
}
Take a look at the official documentation of Badgen to get an overview about how JSON data is processed.
All JSON endpoints return objects to be processed by Shields.io.
{
"schemaVersion": 1,
"label": "typo3",
"message": "inspiring people to share",
"color": "orange",
"isError": false,
"namedLogo": "typo3"
}
Take a look at the official documentation of Shields.io to get an overview about how JSON data is processed. There you will also find ways to override the configuration sent by the API.
🤔 Anything else?
If you are missing something, feel free to create an issue or submit a pull request.
🧡 Like it?
I created this project in my spare time. If you like it, please consider sponsoring me. Thank you!