Começar
Fluxo de Requisição
- Enviar uma Tarefa
Enviar uma requisição
POST
para/api/v1/scraper/request
. - Tratar a Resposta
- HTTP 200 (Sucesso): Os dados são retornados diretamente no corpo da resposta.
- HTTP 201 (Processando): Use o
taskId
fornecido para verificar os resultados.
- Verificar os Resultados
Para tarefas assíncronas, chame repetidamente
/api/v1/scraper/result/{taskId}
até que os dados estejam prontos (HTTP 200).
Códigos de Status HTTP
Código | Significado | Ação |
---|---|---|
200 | Sucesso | Use os dados do corpo da resposta diretamente. |
201 | Tarefa em andamento | Verifique /result/{taskId} (intervalo recomendado: 1-5 segundos). |
400 | Parâmetros inválidos | Verifique se os parâmetros da tarefa são válidos. |
429 | Limite de taxa excedido | Reduza a frequência de solicitações ou entre em contato com o suporte para ajuste de cota. |
500 | Erro interno do servidor | Tente novamente após 1 minuto; entre em contato com o suporte se persistir. |
Exemplos de Código
Fluxo Completo
import { Scrapeless, log } from '@scrapeless-ai/sdk';
const client = new Scrapeless({
apiKey: 'YOUR_API_KEY',
});
async function runTask() {
const result = await client.scraping.scrape({
{
actor: 'scraper.shopee',
input: {
url: 'https://shopee.tw/a-i.10228173.24803858474'
}
},
});
return result;
}
runTask()
.then(data => {
console.log('Data:', data);
})
.catch(error => {
console.error('Error:', error);
});
cURL (Exemplo de Verificação)
curl --location --request GET 'https://api.scrapeless.com/api/v1/scraper/result/30681c8b-bfd3-48eb-a7c9-006e40b00591' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json'
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
actor | string | Serviço de scraping (por exemplo, scraper.shopee). |
input | object | Parâmetros específicos da tarefa (por exemplo, action, url). |
proxy | object | Configuração de proxy opcional com campo country. |
Notas
- Recomendações de Verificação
- Intervalo: 1-5 segundos.
- Tempo limite: Defina um limite máximo de tentativas (por exemplo, 10 tentativas).
- Dicas de Depuração
- Teste primeiro com URLs simples.