Taskem · Desenvolvedores
API do Taskem
API pública REST, read-only e sem autenticação para agentes de IA e desenvolvedores consultarem dados públicos do Taskem — planos, FAQ, artigos do blog e informações do produto. Versão 1.0.0.
Base URL
https://taskem.com.br/api/v1
Autenticação
Nenhuma. Todos os endpoints abaixo são públicos e retornam application/json. Erros também são JSON, no formato { "error": { "code", "message", "hint" } }.
Especificação OpenAPI
A spec OpenAPI 3.1 completa está em https://taskem.com.br/openapi.json. Cada operação tem operationId, descrição e schema tipado — compatível com function-calling de LLMs.
Endpoints
| Método | Rota | Descrição |
|---|---|---|
| GET | /api/v1 | Índice da API e lista de endpoints. |
| GET | /api/v1/plans | Planos, preços e recursos. |
| GET | /api/v1/faq | Perguntas frequentes. |
| GET | /api/v1/blog | Lista de artigos do blog (metadados). |
| GET | /api/v1/blog/{slug} | Um artigo do blog (conteúdo em HTML e Markdown). |
Exemplos
# Índice da API
curl -sS https://taskem.com.br/api/v1
# Planos e preços
curl -sS https://taskem.com.br/api/v1/plans
# Perguntas frequentes
curl -sS https://taskem.com.br/api/v1/faq
# Lista de artigos do blog
curl -sS https://taskem.com.br/api/v1/blog
# Um artigo específico
curl -sS https://taskem.com.br/api/v1/blog/{slug}Rate limiting
As respostas trazem os headers RFC RateLimit para os agentes se auto-regularem: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset e RateLimit-Policy. O limite padrão é 120 requisições por 60 segundos por IP. Ao exceder, a API responde 429 Too Many Requests com o header Retry-After (em segundos) e um corpo JSON de erro.
Versionamento e depreciação
A versão fica no caminho da URL (/api/v1). Mudanças incompatíveis criam uma nova versão (/api/v2) sem alterar a anterior. Quando uma versão ou endpoint for descontinuado, sinalizamos com os headers Deprecation e Sunset (RFC 8594) com no mínimo 90 dias de antecedência, e anunciamos aqui e no /llms.txt. Enquanto não houver esses headers, a versão está ativa e estável.
CLI
Um CLI oficial (Node.js) empacota chamadas à API pública. Uso:
npx @luhstrike/taskem plans npx @luhstrike/taskem faq --limit 3 npx @luhstrike/taskem blog npx @luhstrike/taskem blog <slug> npx @luhstrike/taskem info
Publicado no npm como @luhstrike/taskem. O código vive no diretório cli/ do repositório.
Para agentes de IA
Consulte também o /llms.txt (quando usar o Taskem e como acioná-lo). Qualquer página aceita Accept: text/markdown na home para uma versão legível por máquina.