README.md

metadata

title: Naruto API
emoji: 🍥
colorFrom: red
colorTo: yellow
sdk: docker
app_port: 7860

Naruto API

API didática desenvolvida com FastAPI para consulta de dados do universo Naruto.

Endpoints principais

• / — Página inicial.
• /docs — Documentação automática da API.
• /anime — Informações gerais sobre o anime.
• /personagens — Lista todos os personagens.
• /personagens/{id} — Busca personagem pelo ID.
• /buscar?q=naruto — Busca personagem pelo nome.
• /clas — Lista os clãs cadastrados.
• /clas/{cla} — Busca personagens por clã.
• /vilas — Lista as vilas cadastradas.
• /vilas/{vila} — Busca personagens por vila.
• /ranking-poder — Ranking por nível de poder.
• /estatisticas — Estatísticas gerais.

Como executar localmente

Instale as dependências:

pip install -r requirements.txt

Execute a API:

uvicorn app:app --reload

Acesse:

http://127.0.0.1:8000

Documentação automática:

http://127.0.0.1:8000/docs

Como publicar no Hugging Face Spaces

1. Crie um novo Space no Hugging Face.
2. Escolha o SDK Docker.
3. Envie todos os arquivos deste projeto.
4. Aguarde o build finalizar.
5. Acesse /docs no endereço público do Space.

Sobre as imagens

As imagens dos personagens devem ser colocadas na pasta:

static/imagens/

Os nomes esperados no JSON são:

• naruto.jpg
• sasuke.jpg
• sakura.jpg
• kakashi.jpg
• hinata.jpg
• jiraiya.jpg
• tsunade.jpg
• gaara.jpg
• itachi.jpg
• orochimaru.jpg

Por questões de direitos autorais, este projeto vem com arquivos de instrução no lugar das imagens reais. Substitua os arquivos pela imagem correspondente, mantendo exatamente o mesmo nome.