API de verificação de número em massa da Apple: verificação rápida de número

Verifique os detalhes da Apple do número global de entrada, se é uma conta da Apple

Exemplo de código do arquivo de detecção de upload:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./number.txt"' \
--form 'task_type="apple"'

Exemplo de código de verificação de status da tarefa:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Resposta para o upload do arquivo de detecção bem-sucedido

{
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 20000,
  "estimated_amount": {
    "amount": "2.000000",
    "currency": "USD"
  },
  "message": "Task created successfully. Numbers are being validated and processed in the background.",
  "created_at": "2024-10-19T18:24:56.450567423Z"
}

Resposta para o status de processamento

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Forneça uma resposta indicando que a tarefa foi concluída e inclua o URL de download dos resultados.

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

URL de solicitação de upload de arquivo

POST https://api.checknumber.ai/v1/tasks

Parâmetros de solicitação de upload de arquivo

Parâmetro	Descrição
file	file, Arquivo de upload, cada linha deve conter um número de telefone no formato E.164
task_type	string, Tipo de tarefa, definido como “apple”

URL de solicitação de verificação de status da tarefa

POST https://api.checknumber.ai/v1/gettasks

Parâmetros de solicitação de verificação de status da tarefa

Parâmetro	Descrição
task_id	string, ID da tarefa retornado pela criação da tarefa

Campos de resultado

Campo	Descrição	Exemplo
Number	Número de telefone no formato E.164	+41798284651
apple	Se o número tem uma conta Apple ativa	sim, não

Formato de resposta

Campo	Descrição
created_at	Timestamp de quando a tarefa foi criada
updated_at	Timestamp da última atualização do status da tarefa
task_id	Identificador exclusivo da tarefa
user_id	ID do usuário
status	Status da tarefa: pending: Em fila e aguardando processing: Processando atualmente completed: Processamento concluído exported: Resultados disponíveis para download failed: A tarefa falhou, o valor cobrado é reembolsado automaticamente
total	Total de números de telefone processados
success	Números identificados com sucesso
failure	Números que falharam no processamento
result_url	(Opcional) URL de download para resultados quando o status é exported
actual_amount	(Opcional) Valor efetivamente cobrado, disponível após a liquidação da tarefa
estimated_amount	(Resposta de criação) Valor estimado da tarefa; a cobrança final é liquidada na conclusão

Códigos de status

Status	Descrição
200	free, Solicitação bem-sucedida (ex.: consulta de status)
202	charge, Tarefa criada com sucesso; o valor estimado é deduzido
400	free, Solicitação inválida: parâmetros ou formato de arquivo inválidos, tipo de tarefa não suportado ou entradas válidas abaixo do lote mínimo
401	free, Chave de API ausente ou inválida
402	free, Saldo insuficiente
404	free, Tarefa não encontrada
413	free, Arquivo enviado muito grande
500	free, Erro interno do servidor, tente novamente mais tarde