Docs API · RT Systems

Visao geral

A API trabalha com pedidos assincronos. Voce cria um pedido informando o ID do player e recebe um PedidoId. O envio roda em background e voce consulta o progresso quando quiser.

Sem duplicidade. Cada conta so pode seguir um mesmo player uma unica vez. O sistema guarda o UID de quem ja seguiu e filtra automaticamente nos proximos pedidos.

Limite por alvo100000

FormatoJSON

Authnenhuma

Fluxo de envio

1
Consulte o alvo
Use /api/v2/alvo/<playerid> para saber quantas contas ainda podem seguir.
2
Crie o pedido
Chame /api/v1/craftland?playerid=... e guarde o PedidoId.
3
Acompanhe
Consulte /api/v1/craftland/<PedidoId> a cada segundo ate o status virar COMPLETED.

Niveis do craftland

Em vez de informar a quantidade na mao, voce escolhe o nivel que quer atingir. O sistema sorteia uma meta dentro da faixa de seguranca para garantir que o nivel bata mesmo com arredondamento do jogo.

Nivel	Exigido pelo craftland	Faixa enviada	Parametro
Nivel 7	6.000 seguidores	6.500 a 6.700	`level=7`
Nivel 8	60.000 seguidores	62.000 a 63.000	`level=8`

O parametro aceita 7, nv7, nivel 7, lvl7 ou n7 — tudo normaliza para o mesmo nivel. Sem level, o pedido usa todas as contas elegiveis.

Entrega garantida. A meta conta apenas seguidores entregues com sucesso. Contas que falham voltam para a fila e o pedido roda ate 6 rodadas ate fechar a meta. Uma conta que ja seguiu o player nunca volta.

Contas insuficientes. Como cada conta so pode seguir um player uma vez, o Nivel 8 exige mais de 62.000 contas no pool. Se nao houver, o pedido envia tudo que consegue e termina com status PARTIAL — a criacao ja avisa em MetaGarantida e Aviso.

GET POST /api/v1/craftland

Cria um pedido de envio de seguidores para um player.

Parametros

Nome	Tipo	Local	Descricao
`playerid`	integer	query / json / form	ID numerico do player que vai receber os seguidores. Obrigatorio.
`level`	string	query / json / form	Nivel alvo do craftland: `7` ou `8`. Tambem aceita `nivel` e `nv` como nome do parametro. Opcional.
`quantidade`	integer	query / json / form	Meta manual de seguidores, ignorada se `level` for informado. Opcional.

Exemplo

curl

curl "https://seu-dominio/api/v1/craftland?playerid=123456789&level=7"

Resposta 200

json

{
  "work": true,
  "PedidoId": "6f67dd05-376c-4b4a-baa6-ca098655e383",
  "Status": "QUEUED",
  "PlayerID": "123456789",
  "Nivel": "7",
  "Meta": 6664,
  "Seguidores": 6664,
  "MetaGarantida": true,
  "PosicaoNaFila": 1
}

Campo	Significado
`Meta`	Quantidade de seguidores que o pedido vai perseguir ate conseguir.
`Seguidores`	Quanto da meta e possivel entregar com as contas elegiveis de agora.
`MetaGarantida`	`false` quando faltam contas elegiveis. Vem junto o campo `Aviso` com o numero exato que falta.

Resposta 200 sem contas suficientes

json

{
  "work": true,
  "PedidoId": "4d301982-0a4a-4057-9a5e-7a8094e53c81",
  "Status": "QUEUED",
  "PlayerID": "999000222",
  "Nivel": "8",
  "Meta": 62833,
  "Seguidores": 9000,
  "MetaGarantida": false,
  "PosicaoNaFila": 1,
  "Aviso": "Somente 9000 contas ainda podem seguir este player, faltam 53833 para atingir a meta."
}

Resposta 400

json

{
  "success": false,
  "error": "TODAS_AS_CONTAS_JA_SEGUIRAM",
  "message": "Todas as contas disponiveis ja seguiram este player.",
  "followers_received": 8000
}

Testar agoraexecuta uma chamada real

GET /api/v1/craftland/<PedidoId>

Retorna o progresso do pedido em tempo real.

Resposta 200

json

{
  "work": true,
  "PedidoId": "6f67dd05-376c-4b4a-baa6-ca098655e383",
  "Status": "PROCESSING",
  "PlayerID": "123456789",
  "Nivel": "7",
  "Meta": 6664,
  "MetaGarantida": false,
  "Seguidores": 6664,
  "Progresso": {
    "state": "processing",
    "queue_position": 0,
    "total": 6664,
    "done": 5321,
    "sent": 5989,
    "failed": 668,
    "goal": 6664,
    "rounds": 2,
    "level": "7"
  }
}

Campo	Significado
`goal` / `total`	Meta de seguidores entregues do pedido.
`done`	Seguidores entregues com sucesso. E este que persegue a meta.
`sent`	Tentativas feitas somando todas as rodadas. Pode passar da meta por causa dos retries.
`failed`	Tentativas que falharam e voltaram para a fila de retry.
`rounds`	Rodada atual de retry, de 1 ate 6.
`MetaGarantida`	`true` quando `done` ja alcancou a meta.
`Status`	`QUEUED`, `PROCESSING`, `COMPLETED`, `PARTIAL`, `FAILED` ou `ERROR`.

PARTIAL e um status novo. Ele aparece quando o pedido entregou alguma coisa mas nao fechou a meta por falta de contas elegiveis. Se o seu bot so verifica COMPLETED, trate PARTIAL tambem.

GET /api/v2/niveis

Lista os niveis disponiveis com as faixas de envio.

json

{
  "levels": [
    { "id": "7", "label": "Nivel 7", "requirement": 6000, "minimum": 6500, "maximum": 6700 },
    { "id": "8", "label": "Nivel 8", "requirement": 60000, "minimum": 62000, "maximum": 63000 }
  ]
}

Testar agoraexecuta uma chamada real

GET /api/v2/alvo/<playerid>

Consulta quanto um player ja recebeu e quantas contas ainda podem segui-lo.

json

{
  "player_id": 123456789,
  "seguidores_recebidos": 3200,
  "limite": 100000,
  "restante": 4800,
  "contas_disponiveis": 4800
}

Testar agoraexecuta uma chamada real

GET /api/v2/system

Resumo leve do sistema. Ideal para monitoramento e polling frequente.

json

{
  "contas_logadas": 11250,
  "contas_sendo_logadas": 0,
  "contas_usadas": 0,
  "total_contas": 11250,
  "fila_pedidos": 0,
  "pedidos_ativos": 0
}

Testar agoraexecuta uma chamada real

GET /api/v2/info

Retorna os totais do sistema mais a lista de todos os alvos que ja receberam seguidores.

json

{
  "total_accounts": 11250,
  "logged_accounts": 11250,
  "used_accounts": 0,
  "total_followers_sent": 23000,
  "targets": [
    { "player_id": 123456789, "followers_sent": 8000, "last_update": 1755300000.0 }
  ]
}

GET /api/v2/pedidos

Lista os pedidos mais recentes, do mais novo para o mais antigo.

Nome	Tipo	Padrao	Descricao
`limit`	integer	12	Quantidade de pedidos retornados (1 a 50).

json

{
  "orders": [
    {
      "id": "6f67dd05-376c-4b4a-baa6-ca098655e383",
      "player_id": 123456789,
      "status": "COMPLETED",
      "error": null,
      "total": 8000,
      "sent": 8000,
      "success": 7981,
      "failed": 19,
      "created_at": 1755300000.0,
      "finished_at": 1755300240.0
    }
  ]
}

POST /api/v2/add-conta

Adiciona contas ao pool e dispara o login imediatamente. Aceita texto simples ou JSON.

Corpo em texto

text/plain

6680371748:senha_hash_aqui
6680371749:senha_hash_aqui

Corpo em JSON

application/json

{
  "accounts": [
    { "uid": "6680371748", "password": "senha_hash_aqui" }
  ]
}

Resposta 200

json

{
  "success": true,
  "added": 2,
  "errors": [
    { "uid": "6680371749", "reason": "Conta ja existe no sistema" }
  ],
  "message": "2 accounts added and login initiated"
}

Codigos de erro

Codigo	HTTP	Quando acontece
`CONTA_RECEBEU_SEGUIDORES_ANTERIORMENTE`	400	O player ja bateu o limite de 100000 seguidores.
`TODAS_AS_CONTAS_JA_SEGUIRAM`	400	Nao existe nenhuma conta que ainda nao seguiu esse player.
`SEM_CONTAS_DISPONIVEIS`	400	Nenhuma conta logada no momento.
`ENDPOINT_NOT_FOUND`	404	Rota inexistente. A resposta lista os endpoints validos.
`METHOD_NOT_ALLOWED`	405	Metodo HTTP errado para a rota.
`INTERNAL_SERVER_ERROR`	500	Falha inesperada no servidor.

Formato padrao de erro

json

{
  "success": false,
  "status": 404,
  "error": "ENDPOINT_NOT_FOUND",
  "message": "The endpoint GET /api/v3/foo does not exist on this server.",
  "hint": "Check the path and the HTTP method, then use one of the available endpoints listed below.",
  "requested": { "method": "GET", "path": "/api/v3/foo" },
  "available_endpoints": ["GET/POST /api/v1/craftland", "..."]
}

Regras do sistema

Uma conta segue um player uma unica vez. O UID fica gravado no historico do alvo e ela nunca mais entra em um pedido para o mesmo player, nem nos retries.
A meta conta so o que foi entregue. Falha nao consome a conta: ela volta para a rodada seguinte ate 3 tentativas por pedido.
Ate 6 rodadas por pedido. Quando as contas de uma rodada esgotam as tentativas, o sistema puxa contas novas do pool para fechar a meta.
JWT em renovacao continua enviando. Enquanto o token nao expirou de fato, a conta segue disponivel mesmo com o relogin em andamento. Se um envio voltar sem autorizacao, a conta e relogada na hora e o envio e refeito.
Limite de 100000 por alvo. A contagem acumula entre pedidos diferentes.
Pedidos rodam em fila. Um pedido por vez, na ordem de chegada.
Contas que estouram o proprio limite sao removidas do pool e marcadas como usadas automaticamente.
Historico compacto. Cada alvo gasta 8 bytes por seguidor registrado — 63.000 seguidores ocupam menos de 500 KB.