notabotDocs

Queue-it BotDeflector

Some Queue-it waiting rooms gate entry behind BotDeflector instead of admitting on a redirect: an audio-captcha-style challenge with a proof-of-work step. This solver takes a flow token you already minted on your own session and hands back a ready-to-send request to redeem it.

Type: queueit.botdeflector · Price: €0.0030 per successful solve.

Different from every other solver

Every other type fetches url itself, through your proxy. This one never does: the challenge is solved against Queue-it's own host from the flowToken you send, and url is kept only to check against your approved sites — it is never fetched. You own the Queue-it session throughout; we only solve the audio challenge and build the redeem request.

Request body

POST /v1/solve
{
  "type": "queueit.botdeflector",
  "url": "https://ticket-onlineshop.com/events/x",
  "flowToken": "<the BotDeflector flow token from your own Queue-it session>",
  "checksumHash": "<optional: x-queueit-challange-hash from your softblock page>",
  "proxy": "http://user:pass@host:port"
}
queueit.botdeflector request fields
FieldTypeDescription
urlrequiredstringThe protected page, e.g. the shop URL. Its domain must be approved. Never fetched.
flowTokenrequiredstringThe BotDeflector flow token from your own Queue-it session, up to 4,096 characters.
checksumHashstringThe x-queueit-challange-hash from your softblock page, if you captured it. Given or not, you can redeem the result either way — see below.
proxyif the flow token is IP-boundstringSame format as every other type. Pass the IP that minted the token when the site ties it to an IP.

Fields not listed here are dropped.

Result

queueit.botdeflector result fields
FieldTypeDescription
challengeFlowResultstringThe server-signed proof the challenge was solved. Opaque; passed along inside botdeflector.body.
botdeflectorobjectThe ready request: method, url, headers and body.
200 OK
{
  "ok": true,
  "requestId": "req_Nn8f…",
  "result": {
    "challengeFlowResult": "…",
    "botdeflector": {
      "method": "POST",
      "url": "https://securedbyqueueit.queue-it.net/spa-api/queue/<customerId>/<eventId>/challenge/botdeflector/verify",
      "headers": {
        "x-queueit-challange-customerid": "…",
        "x-queueit-challange-eventid": "…",
        "x-requested-with": "XMLHttpRequest",
        "x-queueit-challange-hash": "… (only when you sent checksumHash)"
      },
      "body": { "challengeType": "botdeflector", "sessionId": "…", "solution": "…", "customerId": "…", "eventId": "…" }
    }
  },
  "cost": 0.003,
  "costMicro": 3000,
  "solveMs": 740
}

Redeeming it

  1. Take result.botdeflector.method, .url, .headers and .body as given.
  2. Add your session's Cookie header. If you did not send checksumHash, also add x-queueit-challange-hash yourself, from your softblock page.
  3. Send it, on the same session that minted the flow token. A real pass continues through the waiting room as normal.

Notes

  • A flow token is single-use: once redeemed (by you, successfully), minting a new one needs a fresh pass through the waiting room's own flow.
  • If the flow token is bound to the IP that minted it, pass that same IP as proxy or the solve will not be accepted by Queue-it.
  • solve_failed is always free. TRANSPORT_ERROR means the backend was unreachable or full — retry the same request. Any other reason means the flow token was rejected (invalid or already used) — mint a fresh one.