Chat with us, powered by LiveChat
← Return to MyDisct Solver

Quick Start Guide

Get started with MyDisct Solver API in minutes. This guide will walk you through your first captcha solving request from setup to implementation.

Prerequisites

MyDisct Account

Sign up if you don't have one

API Key

Available in your dashboard

Account Balance

Add balance to start

HTTP & JSON

Basic knowledge required

Step 1: Get Your API Key

Your API Key

Use this key in all your API requests

You need to log in to see your API key:

  1. Sign up for a free account
  2. Verify your email address
  3. Go to your dashboard
  4. Copy your API key

Step 2: Make Your First Request

Let's solve a simple hCaptcha image challenge. Here's a complete example:

JavaScript 
const API_KEY = 'YOUR_API_KEY';

async function solveCaptcha() {
  const createResponse = await fetch('https://solver-api.mydisct.com/createTask', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'apikey': API_KEY
    },
    body: JSON.stringify({
      auth: { token: API_KEY },
      context: { source: 'api', version: '1.0.0' },
      captcha: {
        type: 'HCAPTCHA_IMAGE',
        metadata: {
          siteUrl: 'https://example.com',
          siteKey: 'a5f74b19-9e45-40e0-b45d-47ff91b7a6c2'
        },
        payload: {
          images: ['base64_image_1...', 'base64_image_2...'],
          question: 'Select all images with traffic lights',
          questionType: 'grid'
        }
      }
    })
  });
  
  const { task } = await createResponse.json();
  
  while (true) {
    await new Promise(r => setTimeout(r, 3000));
    
    const resultResponse = await fetch('https://solver-api.mydisct.com/fetchResult', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json', 'apikey': API_KEY },
      body: JSON.stringify({ taskId: task.id })
    });
    
    const result = await resultResponse.json();
    if (result.task.status === 'completed') {
      return result.task.result.answers;
    }
  }
}

Step 3: Understand the Response

Response Format

{
  "success": true,
  "service": "MyDisct Solver",
  "task": {
    "id": "MyDisctSolver_abc123",
    "status": "completed",
    "result": {
      "answers": [0, 2, 5, 7],
      "timestamp": "2025-12-01T12:34:56Z"
    }
  }
}

Grid Index Reference

0
1
2
3
4
5
6
7
8

Blue = Selected answers [0, 2, 5, 7]

Python Quick Start

Python 
import requests
import time

API_KEY = 'YOUR_API_KEY'

def solve_captcha():
    # Create task
    response = requests.post(
        'https://solver-api.mydisct.com/createTask',
        headers={'Content-Type': 'application/json', 'apikey': API_KEY},
        json={
            'auth': {'token': API_KEY},
            'context': {'source': 'api', 'version': '1.0.0'},
            'captcha': {
                'type': 'HCAPTCHA_IMAGE',
                'metadata': {'siteUrl': 'https://example.com', 'siteKey': 'site-key'},
                'payload': {
                    'images': ['base64_image_1...', 'base64_image_2...'],
                    'question': 'Select all images with traffic lights',
                    'questionType': 'grid'
                }
            }
        }
    )
    task_id = response.json()['task']['id']
    
    # Poll for result
    while True:
        time.sleep(3)
        result = requests.post(
            'https://solver-api.mydisct.com/fetchResult',
            headers={'Content-Type': 'application/json', 'apikey': API_KEY},
            json={'taskId': task_id}
        ).json()
        
        if result['task']['status'] == 'completed':
            return result['task']['result']['answers']

print(solve_captcha())

Testing Your Integration

Testing Checklist

Verify API key works
Test different captcha types
Implement error handling
Test timeout scenarios
Monitor balance & usage
Verify solution accuracy

Common Issues

"Invalid API key"

Make sure you're using the correct API key from your dashboard. Check for extra spaces or characters when copying.

"Insufficient balance"

Add balance to your account before making requests.

Task stays in "processing"

Continue polling. Some captchas take longer. If it exceeds 2 minutes, check your image format and quality.

CORS errors in browser

Never call the API directly from browser JavaScript. Always use a backend server to make API requests.