REST API
Documentação da API
Acesse dados do SkillsMP Skills programaticamente pela nossa API REST. Suporta pesquisa por palavras-chave e filtros por categoria, profissão e idioma detectado no conteúdo do Skill.
table_of_contents.md
Autenticação
Endpoints
GET /api/v1/skills/search
Pesquise skills usando palavras-chave
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| q | string | ✓ | Consulta de pesquisa |
| page | number | - | Número da página (padrão: 1) |
| limit | number | - | Itens por página (padrão: 20; máximo: 50) |
| sortBy | string | - | Ordenação: stars | recent (padrão: recent) |
| category | string | - | Filtre pelo slug da categoria (ex.: data-ai, devops). |
| occupation | string | - | Filtre pelo slug da ocupação SOC (ex.: software-developers). |
| language | string | - | Filtre pelo idioma detectado no conteúdo do Skill. Use um código ISO como en, zh ou ja; mul seleciona conteúdo multilíngue e und conteúdo cujo idioma não pôde ser determinado. |
Limites de uso
- *Anônimo (sem chave de API): 50 requisições/dia, 10/min — apenas pesquisa por palavras-chave
- *Autenticado (com chave de API): 500 requisições/dia, 30/min — pesquisa por palavras-chave
- *Pesquisas com curingas (ex.: *) não são suportadas
Quando presentes, os seguintes cabeçalhos de resposta da busca REST informam o uso da cota diária:
| Header | Descrição |
|---|---|
| X-RateLimit-Daily-Limit | Seu limite diário de requisições |
| X-RateLimit-Daily-Remaining | Requisições restantes hoje |
Exemplos de código
Pesquisa por palavras-chave
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
-H "Authorization: Bearer sk_live_your_api_key"Pesquisa com filtro de ocupação
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=automation&occupation=software-developers&language=zh&sortBy=stars" \
-H "Authorization: Bearer sk_live_your_api_key"Tratamento de erros
A API usa códigos de status HTTP padrão e retorna detalhes de erro em formato JSON.
| Código do erro | HTTP | Descrição |
|---|---|---|
| INVALID_API_KEY | 401 | Chave de API inválida |
| MISSING_QUERY | 400 | Parâmetro de consulta obrigatório ausente |
| INVALID_OCCUPATION | 400 | Slug de ocupação desconhecido |
| INVALID_LANGUAGE | 400 | Código de idioma do conteúdo desconhecido |
| DAILY_QUOTA_EXCEEDED | 429 | Cota diária da API excedida |
| INTERNAL_ERROR | 500 | Erro interno do servidor |
Exemplo de resposta de erro:
json
{
"success": false,
"error": {
"code": "INVALID_API_KEY",
"message": "The provided API key is invalid"
}
}more.md