Altcha

시작하기

JSON 방식 메서드

가이드

토큰 작업

이미지·오디오 작업

Markdown OpenAPI

Altcha

createTask나 in.php로 UNLOCK API에 Altcha 작업을 보내는 방법이에요. 작업 종류 이름, 모든 항목, solution 객체, 프록시 항목, 7개 언어 코드 예시를 담았어요.

가격: $1.30 1건당 $0.0013
보내는 것: 페이지 주소와 challenge 주소 또는 challenge JSON
받는 것: altcha 칸에 넣을 값

소개와 가격

작업 종류 이름

프록시 없이 풀려면 첫 번째 이름을 쓰세요. 내 프록시로 풀려면 두 번째 이름을 쓰고 프록시 항목을 더하세요. 가격은 같아요.

AltchaTaskProxyless프록시 없이

AltchaTask내 프록시 사용

task 객체

type

String필수

작업 종류 이름이에요. 대소문자는 가리지 않아요. AltchaTaskProxyless | AltchaTask

websiteURL

String필수

캡차가 나오는 페이지의 전체 주소예요. http:// 또는 https://로 시작해요.

challengeURL

String선택

페이지가 Altcha challenge를 불러오는 주소예요. 이것이나 challengeJSON 중 하나를 보내세요.

challengeJSON

String선택

Altcha challenge JSON을 글자로 넣어요. 이것이나 challengeURL 중 하나를 보내세요.

여기 없는 항목은 보낸 그대로 풀이 쪽에 넘겨요.

프록시 항목

프록시용 종류 이름일 때만 써요. 항목을 따로 보내거나 proxy 문자열 하나로 보내세요.

proxyType

String필수

http, https, socks4, socks5 중 하나예요.

proxyAddress

String필수

프록시 IP 주소나 호스트 이름이에요.

proxyPort

Integer필수

프록시 포트예요.

proxyLogin

String선택

프록시 사용자 이름이에요. 프록시가 요구할 때만 넣어요.

proxyPassword

String선택

프록시 비밀번호예요. 프록시가 요구할 때만 넣어요.

proxy

String

프록시 항목 전부를 문자열 하나로 넣어요. 예: http://user:pass@1.2.3.4:8080.

프록시 쓰기

요청

POST /createTask

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "AltchaTaskProxyless",
    "websiteURL": "https://example.com/login",
    "challengeURL": "https://example.com/altcha/challenge"
  }
}

solution 객체

status가 ready일 때 solution에 담겨 와요.

token

String

페이지 양식과 함께 낼 토큰이에요.

POST /getTaskResult

{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "eyJhbGdvcml0aG0iOiJTSEEtMjU2Ii..."
  },
  "cost": "0.0013",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

코드 예시

import time, requests

API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "AltchaTaskProxyless",
      "websiteURL": "https://example.com/login",
      "challengeURL": "https://example.com/altcha/challenge"
    }
}).json()
if task["errorId"]:
    raise SystemExit(task["errorCode"])

for _ in range(60):   # 60 x 5 s = the 5 minute task limit
    time.sleep(5)
    r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
    if r["errorId"]:
        raise SystemExit(f"{r['errorCode']}: {r.get('errorDescription', '')}")   # failed tasks are refunded
    if r["status"] == "ready":
        print(r["solution"]["token"])
        break
else:
    raise SystemExit("timed out")

const API = "https://unlock-api.com";
const KEY = "YOUR_API_KEY";
const post = (path, body) => fetch(API + path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body) }).then((r) => r.json());

const task = await post("/createTask", {
  clientKey: KEY,
  task: {
    "type": "AltchaTaskProxyless",
    "websiteURL": "https://example.com/login",
    "challengeURL": "https://example.com/altcha/challenge"
  },
});
if (task.errorId) throw new Error(task.errorCode);

let solution = null;
for (let n = 0; n < 60 && !solution; n++) { // 60 x 5 s = the 5 minute task limit
  await new Promise((r) => setTimeout(r, 5000));
  const r = await post("/getTaskResult", { clientKey: KEY, taskId: task.taskId });
  if (r.errorId) throw new Error(r.errorCode + ": " + r.errorDescription); // failed tasks are refunded
  if (r.status === "ready") solution = r.solution;
}
if (!solution) throw new Error("timed out");
console.log(solution.token);

<?php
$api = "https://unlock-api.com";
$key = "YOUR_API_KEY";
function post($url, $body) {
  $c = curl_init($url);
  curl_setopt_array($c, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json"], CURLOPT_POSTFIELDS => json_encode($body)]);
  return json_decode(curl_exec($c), true);
}
$task = post("$api/createTask", ["clientKey" => $key, "task" => json_decode('{"type":"AltchaTaskProxyless","websiteURL":"https://example.com/login","challengeURL":"https://example.com/altcha/challenge"}', true)]);
if ($task["errorId"]) exit($task["errorCode"]);
for ($n = 0; $n < 60; $n++) { // 60 x 5 s = the 5 minute task limit
  sleep(5);
  $r = post("$api/getTaskResult", ["clientKey" => $key, "taskId" => $task["taskId"]]);
  if ($r["errorId"]) exit($r["errorCode"] . ": " . $r["errorDescription"]); // failed tasks are refunded
  if ($r["status"] === "ready") break;
}
if ($r["status"] !== "ready") exit("timed out");
print_r($r["solution"]["token"]);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"time"
)

const api = "https://unlock-api.com"
const key = "YOUR_API_KEY"

func post(method string, body map[string]any) map[string]any {
	b, _ := json.Marshal(body)
	res, err := http.Post(api+"/"+method, "application/json", bytes.NewReader(b))
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	var out map[string]any
	json.NewDecoder(res.Body).Decode(&out)
	return out
}

func main() {
	task := post("createTask", map[string]any{
		"clientKey": key,
		"task": map[string]any{
			"type": "AltchaTaskProxyless",
			"websiteURL": "https://example.com/login",
			"challengeURL": "https://example.com/altcha/challenge",
		},
	})
	if task["errorId"].(float64) != 0 {
		panic(task["errorCode"])
	}
	for n := 0; n < 60; n++ { // 60 x 5 s = the 5 minute task limit
		time.Sleep(5 * time.Second)
		r := post("getTaskResult", map[string]any{"clientKey": key, "taskId": task["taskId"]})
		if r["errorId"].(float64) != 0 {
			panic(r["errorCode"]) // failed tasks are refunded
		}
		if r["status"] == "ready" {
			fmt.Println(r["solution"])
			return
		}
	}
	panic("timed out")
}

import java.net.URI;
import java.net.http.*;
import java.util.regex.*;

public class Solve {
  static final String API = "https://unlock-api.com", KEY = "YOUR_API_KEY";
  static final HttpClient HTTP = HttpClient.newHttpClient();

  static String post(String method, String json) throws Exception {
    var req = HttpRequest.newBuilder(URI.create(API + "/" + method))
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(json)).build();
    return HTTP.send(req, HttpResponse.BodyHandlers.ofString()).body();
  }

  public static void main(String[] args) throws Exception {
    String task = "{\"type\":\"AltchaTaskProxyless\",\"websiteURL\":\"https://example.com/login\",\"challengeURL\":\"https://example.com/altcha/challenge\"}";
    String created = post("createTask", "{\"clientKey\":\"" + KEY + "\",\"task\":" + task + "}");
    Matcher id = Pattern.compile("\"taskId\":(\\d+)").matcher(created);
    if (!id.find()) throw new RuntimeException(created);
    for (int n = 0; n < 60; n++) { // 60 x 5 s = the 5 minute task limit
      Thread.sleep(5000);
      String r = post("getTaskResult", "{\"clientKey\":\"" + KEY + "\",\"taskId\":" + id.group(1) + "}");
      if (r.contains("\"errorId\":1")) throw new RuntimeException(r); // failed tasks are refunded
      if (r.contains("\"status\":\"ready\"")) { System.out.println(r); return; }
    }
    throw new RuntimeException("timed out");
  }
}

using System.Net.Http.Json;
using System.Text.Json;

const string Api = "https://unlock-api.com";
const string Key = "YOUR_API_KEY";
var http = new HttpClient();

async Task<JsonElement> Post(string method, object body) =>
    await (await http.PostAsJsonAsync($"{Api}/{method}", body)).Content.ReadFromJsonAsync<JsonElement>();

var task = await Post("createTask", new {
    clientKey = Key,
    task = JsonSerializer.Deserialize<JsonElement>("""
        {"type":"AltchaTaskProxyless","websiteURL":"https://example.com/login","challengeURL":"https://example.com/altcha/challenge"}
        """)
});
if (task.GetProperty("errorId").GetInt32() != 0) throw new Exception(task.GetProperty("errorCode").GetString());

for (var n = 0; n < 60; n++) { // 60 x 5 s = the 5 minute task limit
    await Task.Delay(5000);
    var r = await Post("getTaskResult", new { clientKey = Key, taskId = task.GetProperty("taskId").GetInt64() });
    if (r.GetProperty("errorId").GetInt32() != 0) throw new Exception(r.GetProperty("errorCode").GetString()); // failed tasks are refunded
    if (r.GetProperty("status").GetString() == "ready") { Console.WriteLine(r.GetProperty("solution")); return; }
}
throw new Exception("timed out");

curl -s https://unlock-api.com/createTask \
  -H "Content-Type: application/json" \
  -d '{"clientKey":"YOUR_API_KEY","task":{"type":"AltchaTaskProxyless","websiteURL":"https://example.com/login","challengeURL":"https://example.com/altcha/challenge"}}'
# {"errorId":0,"taskId":1001}

curl -s https://unlock-api.com/getTaskResult \
  -H "Content-Type: application/json" \
  -d '{"clientKey":"YOUR_API_KEY","taskId":1001}'
# {"errorId":0,"status":"processing"}  then  {"errorId":0,"status":"ready","solution":{...},"cost":"0.001"}

in.php 폼 방식

같은 작업을 예전 폼 요청으로 보내는 방법이에요. res.php가 답을 글자로 돌려줘요.

in.php, res.php

curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=altcha&challengeURL=CHALLENGE_URL&pageurl=https://example.com/login&json=1"
# {"status":1,"request":"1001"}

curl -s "https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&id=1001&json=1"
# {"status":0,"request":"CAPCHA_NOT_READY"}  then  {"status":1,"request":"ANSWER"}

폼 API: in.php와 res.php

Altcha

작업 종류 이름

task 객체

프록시 항목

요청

solution 객체

코드 예시

in.php 폼 방식

계정 만들기

계정 만들기