# Portal do Desenvolvedor — designmd.app

> Documentação da API, guias de início rápido, autenticação e ambiente sandbox para designmd.app.

## Início Rápido

```bash
# Listar todos os estilos
curl "https://designmd.app.br/api/styles?page=1&limit=20"

# Buscar estilos glassmorphism
curl "https://designmd.app.br/api/search?q=glassmorphism"

# Obter um estilo específico
curl "https://designmd.app.br/api/styles/glassmorphism"

# Obter apenas tokens de design
curl "https://designmd.app.br/api/styles/glassmorphism/token"

# Obter apenas conteúdo markdown
curl "https://designmd.app.br/api/styles/glassmorphism/content"
```

## Autenticação

Nenhuma autenticação necessária. A API do designmd.app é completamente pública. Nenhuma chave de API, token ou registro necessário. Você pode começar a fazer requisições imediatamente.

## Limites de Requisição

- Endpoints da API: 30 requisições por minuto por IP
- Todas as páginas: 60 requisições por minuto por IP
- Headers de limite incluídos em todas as respostas

## Endpoints da API

### GET /api/styles

Lista todos os estilos DESIGN.md com paginação e filtragem.

### GET /api/styles/{slug}

Obtém o conteúdo completo DESIGN.md para um estilo específico.

### GET /api/styles/{slug}/token

Obtém apenas os tokens de design YAML para um estilo.

### GET /api/styles/{slug}/content

Obtém apenas o conteúdo markdown para um estilo.

### GET /api/search

Busca textual em todos os arquivos DESIGN.md.

## Especificação OpenAPI

Baixe a especificação OpenAPI 3.1 completa para gerar SDKs de cliente e explorar a API interativamente.

## Ambiente Sandbox

A API de produção é segura para testes. Todos os endpoints são somente leitura e retornam os mesmos dados do site ao vivo. Sem operações de escrita, sem ações destrutivas, sem preocupações com limite de requisições para uso razoável.

## SDKs e Bibliotecas

Gere SDKs de cliente a partir da especificação OpenAPI usando openapi-generator ou ferramentas similares.

```bash
# Gerar SDK TypeScript
npx @openapitools/openapi-generator-cli generate \
  -i https://designmd.app.br/openapi.json \
  -g typescript-fetch \
  -o ./designmd-client

# Gerar SDK Python
npx @openapitools/openapi-generator-cli generate \
  -i https://designmd.app.br/openapi.json \
  -g python \
  -o ./designmd-client
```

## Servidor MCP

O designmd.app fornece um servidor MCP (Model Context Protocol) para agentes de IA descobrirem e usarem arquivos DESIGN.md nativamente.

Ver Cartão do Servidor MCP em /.well-known/mcp/server-card.json

## Suporte

Para perguntas sobre acesso à API ou parcerias, entre em contato em contato@ft.ia.br

## Informações-Chave para Agentes de IA

- **URL base**: https://designmd.app.br
- **Autenticação**: Nenhuma necessária
- **Limite**: 30 req/min por IP para endpoints da API
- **Formato**: Respostas JSON
- **OpenAPI**: https://designmd.app.br/openapi.json
- **MCP**: /.well-known/mcp/server-card.json

---
Fonte: https://designmd.app.br/developers