Site · Catálogo · Início Rápido · API · Reportar Bug · Solicitar Badge
FIAP Achievements é um serviço open-source que permite que estudantes exibam suas conquistas da FIAP — Nano Courses, Challenges e Global Solutions — diretamente no GitHub, portfólios e qualquer lugar que renderize imagens HTML.
Cada badge é um SVG nítido, servido por API com cache CDN de 1 ano, disponível em três temas de cor. Nenhuma chave de API. Nenhum cadastro. Apenas uma <img>.
- 🌐 Site e Catálogo
- 🚀 Início Rápido
- 📡 Referência da API
- 🏅 Catálogo de Badges
- 💡 Exemplos de Uso
- 🏗️ Arquitetura
- ⚙️ Rodando Localmente
- 🤝 Contribuindo
- 🔒 Segurança
- 📄 Licença
A forma mais fácil de encontrar suas badges é pelo site — sem precisar decorar IDs ou slugs.
| Página | URL | O que você encontra |
|---|---|---|
| Home | fiap-achievements.vercel.app/home | Visão geral do projeto e como usar |
| Catálogo | fiap-achievements.vercel.app/catalog | Todas as badges com busca e filtros por categoria |
No catálogo você encontra os IDs dos Nano Courses e os slugs de Challenge e Global Solution que precisa para montar sua URL.
Cole o ID diretamente no parâmetro badge:
<img src="https://fiap-achievements.vercel.app/api/badge?badge=SEU_ID&theme=dark" width="100" /><img src="https://fiap-achievements.vercel.app/api/badge?badge=challenge&year=2025&company=EMPRESA&ranking=1&theme=dark" width="100" /><img src="https://fiap-achievements.vercel.app/api/badge?badge=gs&year=2025&topic=TOPICO&theme=dark" width="100" />Onde encontrar os valores? Acesse o Catálogo ou consulte o Catálogo de Badges abaixo.
Pré-visualização de qualquer badge:
https://fiap-achievements.vercel.app/badge?badge=SEU_ID&theme=dark
Retorna a imagem SVG da badge solicitada. Sempre retorna HTTP 200 com Content-Type: image/svg+xml — em caso de erro, serve um SVG de erro temático. A tag <img> nunca quebra.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
badge |
string |
✅ | — | ID numérico do Nano Course ou tipo: challenge, gs |
theme |
string |
❌ | dark |
Tema visual: light, dark ou black |
year |
number |
✅ challenge / gs | — | Ano da edição (ex: 2025) |
company |
string |
✅ challenge | — | Slug da empresa parceira (ex: jovi) |
topic |
string |
✅ gs | — | Slug do tema da G.S (ex: future-of-work) |
ranking |
number |
❌ challenge | 1 |
Posição: 1, 2 ou 3 |
| Tipo | badge= |
Parâmetros obrigatórios | Exemplo |
|---|---|---|---|
| Nano Course | ID numérico | — | https://fiap-achievements.vercel.app/api/badge?badge=294870&theme=dark |
| Challenge | challenge |
year, company |
https://fiap-achievements.vercel.app/api/badge?badge=challenge&year=2025&company=jovi&ranking=1 |
| Global Solution | gs |
year, topic |
https://fiap-achievements.vercel.app/api/badge?badge=gs&year=2025&topic=future-of-work |
Três temas disponíveis. Escolha o que melhor combina com o fundo do seu perfil.
| Tema | Parâmetro | Ideal para |
|---|---|---|
| Light | light |
READMEs e portfólios com fundo claro |
| Dark | dark |
READMEs e perfis com fundo escuro |
| Black | black |
Fundos OLED / preto total |
| Cabeçalho | Badge encontrada | Fallback / Erro |
|---|---|---|
Content-Type |
image/svg+xml |
image/svg+xml |
Cache-Control |
public, immutable, max-age=31536000 |
public, max-age=60 |
X-Badge-Status |
ok |
not-found · bad-request · internal-error |
Badges ficam em cache por 1 ano na CDN — carregam instantaneamente em qualquer lugar.
💡 Dica: prefira navegar pelo catálogo interativo — ele tem busca, filtros e preview em tempo real.
Todas as badges estão disponíveis nos três temas. As pré-visualizações abaixo exibem a variante light.
Busque pelo ID numérico do curso diretamente no parâmetro badge:
https://fiap-achievements.vercel.app/api/badge?badge=SEU_ID&theme=dark
| Pré-visualização | ID | Copiar URL |
|---|---|---|
108275 |
https://fiap-achievements.vercel.app/api/badge?badge=108275&theme=light |
|
128573 |
https://fiap-achievements.vercel.app/api/badge?badge=128573&theme=light |
|
140892 |
https://fiap-achievements.vercel.app/api/badge?badge=140892&theme=light |
|
145807 |
https://fiap-achievements.vercel.app/api/badge?badge=145807&theme=light |
|
146952 |
https://fiap-achievements.vercel.app/api/badge?badge=146952&theme=light |
|
149382 |
https://fiap-achievements.vercel.app/api/badge?badge=149382&theme=light |
|
150738 |
https://fiap-achievements.vercel.app/api/badge?badge=150738&theme=light |
|
158904 |
https://fiap-achievements.vercel.app/api/badge?badge=158904&theme=light |
|
162483 |
https://fiap-achievements.vercel.app/api/badge?badge=162483&theme=light |
|
179458 |
https://fiap-achievements.vercel.app/api/badge?badge=179458&theme=light |
|
193674 |
https://fiap-achievements.vercel.app/api/badge?badge=193674&theme=light |
|
193820 |
https://fiap-achievements.vercel.app/api/badge?badge=193820&theme=light |
|
195438 |
https://fiap-achievements.vercel.app/api/badge?badge=195438&theme=light |
|
214690 |
https://fiap-achievements.vercel.app/api/badge?badge=214690&theme=light |
|
218574 |
https://fiap-achievements.vercel.app/api/badge?badge=218574&theme=light |
|
248960 |
https://fiap-achievements.vercel.app/api/badge?badge=248960&theme=light |
|
249537 |
https://fiap-achievements.vercel.app/api/badge?badge=249537&theme=light |
|
251907 |
https://fiap-achievements.vercel.app/api/badge?badge=251907&theme=light |
|
257108 |
https://fiap-achievements.vercel.app/api/badge?badge=257108&theme=light |
|
261840 |
https://fiap-achievements.vercel.app/api/badge?badge=261840&theme=light |
|
276841 |
https://fiap-achievements.vercel.app/api/badge?badge=276841&theme=light |
|
281496 |
https://fiap-achievements.vercel.app/api/badge?badge=281496&theme=light |
|
284169 |
https://fiap-achievements.vercel.app/api/badge?badge=284169&theme=light |
|
284705 |
https://fiap-achievements.vercel.app/api/badge?badge=284705&theme=light |
|
294870 |
https://fiap-achievements.vercel.app/api/badge?badge=294870&theme=light |
|
314785 |
https://fiap-achievements.vercel.app/api/badge?badge=314785&theme=light |
|
320654 |
https://fiap-achievements.vercel.app/api/badge?badge=320654&theme=light |
|
325740 |
https://fiap-achievements.vercel.app/api/badge?badge=325740&theme=light |
|
348275 |
https://fiap-achievements.vercel.app/api/badge?badge=348275&theme=light |
|
367981 |
https://fiap-achievements.vercel.app/api/badge?badge=367981&theme=light |
|
370618 |
https://fiap-achievements.vercel.app/api/badge?badge=370618&theme=light |
|
374692 |
https://fiap-achievements.vercel.app/api/badge?badge=374692&theme=light |
|
386429 |
https://fiap-achievements.vercel.app/api/badge?badge=386429&theme=light |
|
390715 |
https://fiap-achievements.vercel.app/api/badge?badge=390715&theme=light |
|
410593 |
https://fiap-achievements.vercel.app/api/badge?badge=410593&theme=light |
|
431597 |
https://fiap-achievements.vercel.app/api/badge?badge=431597&theme=light |
|
432981 |
https://fiap-achievements.vercel.app/api/badge?badge=432981&theme=light |
|
458721 |
https://fiap-achievements.vercel.app/api/badge?badge=458721&theme=light |
|
468250 |
https://fiap-achievements.vercel.app/api/badge?badge=468250&theme=light |
|
469128 |
https://fiap-achievements.vercel.app/api/badge?badge=469128&theme=light |
|
470315 |
https://fiap-achievements.vercel.app/api/badge?badge=470315&theme=light |
|
482731 |
https://fiap-achievements.vercel.app/api/badge?badge=482731&theme=light |
|
492673 |
https://fiap-achievements.vercel.app/api/badge?badge=492673&theme=light |
|
495183 |
https://fiap-achievements.vercel.app/api/badge?badge=495183&theme=light |
|
503194 |
https://fiap-achievements.vercel.app/api/badge?badge=503194&theme=light |
|
507934 |
https://fiap-achievements.vercel.app/api/badge?badge=507934&theme=light |
|
517862 |
https://fiap-achievements.vercel.app/api/badge?badge=517862&theme=light |
|
537186 |
https://fiap-achievements.vercel.app/api/badge?badge=537186&theme=light |
|
540126 |
https://fiap-achievements.vercel.app/api/badge?badge=540126&theme=light |
|
561239 |
https://fiap-achievements.vercel.app/api/badge?badge=561239&theme=light |
|
573846 |
https://fiap-achievements.vercel.app/api/badge?badge=573846&theme=light |
|
605219 |
https://fiap-achievements.vercel.app/api/badge?badge=605219&theme=light |
|
627840 |
https://fiap-achievements.vercel.app/api/badge?badge=627840&theme=light |
|
631728 |
https://fiap-achievements.vercel.app/api/badge?badge=631728&theme=light |
|
640281 |
https://fiap-achievements.vercel.app/api/badge?badge=640281&theme=light |
|
645372 |
https://fiap-achievements.vercel.app/api/badge?badge=645372&theme=light |
|
670821 |
https://fiap-achievements.vercel.app/api/badge?badge=670821&theme=light |
|
675431 |
https://fiap-achievements.vercel.app/api/badge?badge=675431&theme=light |
|
682491 |
https://fiap-achievements.vercel.app/api/badge?badge=682491&theme=light |
|
684325 |
https://fiap-achievements.vercel.app/api/badge?badge=684325&theme=light |
|
692314 |
https://fiap-achievements.vercel.app/api/badge?badge=692314&theme=light |
|
697314 |
https://fiap-achievements.vercel.app/api/badge?badge=697314&theme=light |
|
703951 |
https://fiap-achievements.vercel.app/api/badge?badge=703951&theme=light |
|
714608 |
https://fiap-achievements.vercel.app/api/badge?badge=714608&theme=light |
|
721963 |
https://fiap-achievements.vercel.app/api/badge?badge=721963&theme=light |
|
735018 |
https://fiap-achievements.vercel.app/api/badge?badge=735018&theme=light |
|
736418 |
https://fiap-achievements.vercel.app/api/badge?badge=736418&theme=light |
|
748350 |
https://fiap-achievements.vercel.app/api/badge?badge=748350&theme=light |
|
752906 |
https://fiap-achievements.vercel.app/api/badge?badge=752906&theme=light |
|
758230 |
https://fiap-achievements.vercel.app/api/badge?badge=758230&theme=light |
|
761905 |
https://fiap-achievements.vercel.app/api/badge?badge=761905&theme=light |
|
781293 |
https://fiap-achievements.vercel.app/api/badge?badge=781293&theme=light |
|
785063 |
https://fiap-achievements.vercel.app/api/badge?badge=785063&theme=light |
|
793412 |
https://fiap-achievements.vercel.app/api/badge?badge=793412&theme=light |
|
798451 |
https://fiap-achievements.vercel.app/api/badge?badge=798451&theme=light |
|
810254 |
https://fiap-achievements.vercel.app/api/badge?badge=810254&theme=light |
|
812064 |
https://fiap-achievements.vercel.app/api/badge?badge=812064&theme=light |
|
820547 |
https://fiap-achievements.vercel.app/api/badge?badge=820547&theme=light |
|
829145 |
https://fiap-achievements.vercel.app/api/badge?badge=829145&theme=light |
|
830617 |
https://fiap-achievements.vercel.app/api/badge?badge=830617&theme=light |
|
835758 |
https://fiap-achievements.vercel.app/api/badge?badge=835758&theme=light |
|
849216 |
https://fiap-achievements.vercel.app/api/badge?badge=849216&theme=light |
|
856024 |
https://fiap-achievements.vercel.app/api/badge?badge=856024&theme=light |
|
860192 |
https://fiap-achievements.vercel.app/api/badge?badge=860192&theme=light |
|
860741 |
https://fiap-achievements.vercel.app/api/badge?badge=860741&theme=light |
|
861429 |
https://fiap-achievements.vercel.app/api/badge?badge=861429&theme=light |
|
862174 |
https://fiap-achievements.vercel.app/api/badge?badge=862174&theme=light |
|
864195 |
https://fiap-achievements.vercel.app/api/badge?badge=864195&theme=light |
|
903715 |
https://fiap-achievements.vercel.app/api/badge?badge=903715&theme=light |
|
907158 |
https://fiap-achievements.vercel.app/api/badge?badge=907158&theme=light |
|
907326 |
https://fiap-achievements.vercel.app/api/badge?badge=907326&theme=light |
|
913674 |
https://fiap-achievements.vercel.app/api/badge?badge=913674&theme=light |
|
914502 |
https://fiap-achievements.vercel.app/api/badge?badge=914502&theme=light |
|
915204 |
https://fiap-achievements.vercel.app/api/badge?badge=915204&theme=light |
|
918357 |
https://fiap-achievements.vercel.app/api/badge?badge=918357&theme=light |
|
924560 |
https://fiap-achievements.vercel.app/api/badge?badge=924560&theme=light |
|
925781 |
https://fiap-achievements.vercel.app/api/badge?badge=925781&theme=light |
|
928143 |
https://fiap-achievements.vercel.app/api/badge?badge=928143&theme=light |
|
934705 |
https://fiap-achievements.vercel.app/api/badge?badge=934705&theme=light |
|
986241 |
https://fiap-achievements.vercel.app/api/badge?badge=986241&theme=light |
|
991000 |
https://fiap-achievements.vercel.app/api/badge?badge=991000&theme=light |
Passe badge=challenge e informe year, company e opcionalmente ranking (padrão: 1):
https://fiap-achievements.vercel.app/api/badge?badge=challenge&year=ANO&company=EMPRESA&ranking=1&theme=light
| Empresa | 🥇 1º lugar | 🥈 2º lugar | 🥉 3º lugar |
|---|---|---|---|
Jovi (jovi) |
|||
Soul Up (soul-up) |
|||
TOTVS (totvs) |
| Empresa | 🥇 1º lugar | 🥈 2º lugar | 🥉 3º lugar |
|---|---|---|---|
B3 (b3) |
|||
CCR (ccr) |
|||
Click Go (click-go) |
|||
Fortinet (fortinet) |
|||
HC IBM (hc-ibm) |
|||
Odontoprev (odontoprev) |
|||
Oracle (oracle) |
|||
Passa a Bola (passaabola) |
|||
Santander (santander) |
|||
Smartlabs (smartlabs) |
|||
Vivo (vivo) |
Passe badge=gs e informe year e topic:
https://fiap-achievements.vercel.app/api/badge?badge=gs&year=ANO&topic=TOPICO&theme=light
| Tema | Light | Dark | Black |
|---|---|---|---|
Future of Work (future-of-work) |
<div align="center">
<img src="https://fiap-achievements.vercel.app/api/badge?badge=294870&theme=dark" width="100" />
<img src="https://fiap-achievements.vercel.app/api/badge?badge=864195&theme=dark" width="100" />
<img src="https://fiap-achievements.vercel.app/api/badge?badge=928143&theme=dark" width="100" />
</div><img src="https://fiap-achievements.vercel.app/api/badge?badge=challenge&year=2025&company=oracle&ranking=1&theme=dark" width="100" /><img src="https://fiap-achievements.vercel.app/api/badge?badge=gs&year=2025&topic=future-of-work&theme=dark" width="100" /><div style="display: flex; gap: 16px; flex-wrap: wrap; justify-content: center;">
<img src="https://fiap-achievements.vercel.app/api/badge?badge=294870&theme=light" width="100" />
<img src="https://fiap-achievements.vercel.app/api/badge?badge=challenge&year=2025&company=oracle&ranking=1&theme=light" width="100" />
<img src="https://fiap-achievements.vercel.app/api/badge?badge=gs&year=2025&topic=future-of-work&theme=light" width="100" />
</div>fiap-achievements/
├── api/
│ └── badge.js # Serverless function (Vercel)
├── public/
│ └── assets/
│ └── certificates/
│ ├── nano/
│ │ ├── light/ {id}.svg
│ │ ├── dark/ {id}.svg
│ │ └── black/ {id}.svg
│ ├── challenge/
│ │ └── {year}/{company}/
│ │ ├── light/ {ranking}.svg
│ │ ├── dark/ {ranking}.svg
│ │ └── black/ {ranking}.svg
│ ├── gs/
│ │ └── {year}/{topic}/
│ │ ├── light/ 1.svg
│ │ ├── dark/ 1.svg
│ │ └── black/ 1.svg
│ ├── error-light.svg
│ ├── error-dark.svg
│ └── error-black.svg
├── src/
│ ├── components/
│ │ ├── Header.jsx
│ │ └── Footer.jsx
│ ├── routes/
│ │ ├── Home.jsx # Página inicial (/home)
│ │ ├── Catalog.jsx # Catálogo interativo (/catalog)
│ │ └── Badges.jsx # Pré-visualização (/badge)
│ ├── hooks/
│ │ └── useCatalog.js
│ ├── css/
│ ├── App.jsx
│ └── main.jsx
├── .github/
│ ├── workflows/
│ │ ├── ci.yml # Lint e build em todo PR/push para main
│ │ └── validate-badges.yml # Validação de SVGs em PRs com badges
│ └── pull_request_template.md
├── vercel.json
└── vite.config.js
Rotas da aplicação:
| Rota | Descrição |
|---|---|
/home |
Página inicial com visão geral do projeto |
/catalog |
Catálogo interativo com busca e filtros |
/badge |
Pré-visualização de qualquer badge por parâmetros de URL |
/api/badge |
Endpoint da serverless function — retorna o SVG |
Fluxo da API:
GET /api/badge?badge=...&theme=...
│
├─ badge numérico → nano/{theme}/{id}.svg
├─ badge=challenge → challenge/{year}/{company}/{theme}/{ranking}.svg
└─ badge=gs → gs/{year}/{topic}/{theme}/1.svg
│
├─ arquivo encontrado → SVG + cache 1 ano
└─ não encontrado → error-{theme}.svg + cache 60s
Pré-requisitos: Node.js ≥ 18, npm
# 1. Clone o repositório
git clone https://github.com/leoosilvp/fiap-achievements.git
cd fiap-achievements
# 2. Instale as dependências
npm install
# 3. Inicie o servidor de desenvolvimento
npm run devAtenção: o endpoint
/api/badgerequer o runtime da Vercel. Use a Vercel CLI para suporte completo ao backend local.
npm i -g vercel
vercel devContribuições são bem-vindas e ajudam a expandir o catálogo da comunidade.
Adicione os SVGs nos três temas:
public/assets/certificates/nano/light/{id}.svg
public/assets/certificates/nano/dark/{id}.svg
public/assets/certificates/nano/black/{id}.svg
Crie a estrutura de diretórios com os três rankings para cada tema:
public/assets/certificates/challenge/{year}/{company}/light/{ranking}.svg
public/assets/certificates/challenge/{year}/{company}/dark/{ranking}.svg
public/assets/certificates/challenge/{year}/{company}/black/{ranking}.svg
Rankings
1,2e3são obrigatórios para cada empresa e tema.
public/assets/certificates/gs/{year}/{topic}/light/1.svg
public/assets/certificates/gs/{year}/{topic}/dark/1.svg
public/assets/certificates/gs/{year}/{topic}/black/1.svg
- SVGs devem estar otimizados e abaixo de 300 KB
- Os três temas (
light,dark,black) são obrigatórios - Nenhum ID duplicado dentro do mesmo tipo
- Abra um Pull Request com descrição clara — o template guia o preenchimento
npm install # instalar dependências
npm run dev # servidor local (frontend)
npm run lint # lint
npm run build # build de produção
vercel dev # servidor local com suporte ao endpoint /api/badgeTodos os parâmetros fornecidos pelo usuário são sanitizados antes de qualquer uso — apenas [a-z0-9\-_] é permitido em slugs e apenas dígitos em valores numéricos. A API nunca executa path traversal, nunca expõe o sistema de arquivos além de public/assets/certificates/ e nunca retorna uma página de erro HTTP.
Distribuído sob a Licença MIT.
Lets Rock The Future