Scraping APIIntrodução rápidaComeçando

Começar

Fluxo de Solicitação

  1. Enviar uma Tarefa Envie uma solicitação POST para /api/v1/scraper/request.
  2. Lidar com a Resposta
    1. HTTP 200 (Sucesso): Os dados são retornados diretamente no corpo da resposta.
    2. HTTP 201 (Processando): Use o taskId fornecido para verificar os resultados.
  3. 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ódigoSignificadoAção
200SucessoUse os dados do corpo da resposta diretamente.
201Tarefa em andamentoVerifique /result/{taskId} (intervalo recomendado: 1-5 segundos).
400Parâmetros inválidosVerifique se os parâmetros da tarefa são válidos.
429Limite de taxa excedidoReduza a frequência de solicitações ou entre em contato com o suporte para ajuste de cota.
500Erro interno do servidorTente novamente após 1 minuto; entre em contato com o suporte se o problema persistir.

Exemplos de Código

Fluxo Completo

import { Scrapeless } 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âmetroTipoDescrição
actorstringServiço de scraping (por exemplo, scraper.shopee).
inputobjectParâmetros específicos da tarefa (por exemplo, ação, url).
proxyobjectConfiguração de proxy opcional com campo de país.

Notas

  1. Recomendações de Verificação
    1. Intervalo: 1-5 segundos.
    2. Tempo limite: Defina um limite máximo de tentativas (por exemplo, 10 tentativas).
  2. Dicas de Depuração
    1. Teste primeiro com URLs simples.