API가 없는 프로그램도
API로 부르세요
오래된 업무 프로그램을 한 번 클릭해 보이면 작업으로 저장됩니다. 승인한 작업은 다른 시스템에서 HTTP 요청 한 번으로 실행합니다.
POST /jobs/add_customer
Authorization: Bearer ••••••
{"input1": "한빛상사"}
{"outputs": {"result": "C-1024"}, "ms": 1840}
SWGateway는 무엇인가요?
API를 제공하지 않는 윈도우 프로그램을 다른 시스템과 연결하는 트레이 앱입니다. 사람이 하던 클릭과 입력을 작업으로 등록해 두면, 그 프로그램이 설치된 PC에서 API 호출로 대신 실행하고 결과를 돌려줍니다. 등록하고 승인한 작업만 실행합니다.
프로그램은 이렇게 생겼습니다
탭을 눌러 화면을 둘러보세요. 윈도우 기본 프로그램인 문자표를 작업으로 등록한 예시입니다.
| 이름 | 상태 | 단계 | API 주소 |
|---|---|---|---|
| charmap_text | 승인됨 | 2 | POST http://127.0.0.1:18787/jobs/charmap_text |
시험 입력값 (JSON)과 결과. 승인된 작업만 API로 실행됩니다.
{
"text": "한빛상사"
}
{
"outputs": {
"result": "한빛상사"
},
"ms": 3949
}
대상 프로그램에서 평소처럼 클릭하세요. 입력 칸을 클릭하면 API 입력값 자리로 저장됩니다. 키보드 입력은 기록하지 않습니다.
| 동작 | 항목 | 입력 이름 | 결과 이름 |
|---|---|---|---|
| set_text | id=104 | text | |
| read | id=104 | result |
| 시각(UTC) | 작업 | 결과 | ms | 실패 단계 | 내용 |
|---|---|---|---|---|---|
| 2026-10-31 03:00:05 | charmap_text | 성공 | 2097 | ||
| 2026-10-31 03:00:00 | charmap_text | 성공 | 2148 | ||
| 2026-10-31 02:58:41 | charmap_text | 실패 | 12041 | 0 | 대상 창을 찾지 못했습니다. |
API 실행 중: http://127.0.0.1:18787 (이 PC 안에서만 접속 가능)
API 토큰
버전 1.0.2
실제 프로그램의 화면 구성과 실행 결과를 웹으로 옮긴 미리보기입니다. 버튼은 동작하지 않으며, 탭만 눌러 볼 수 있습니다.
녹화하고, 승인하고, 호출합니다
-
클릭해서 녹화
대상 프로그램을 평소처럼 클릭합니다. 화면 좌표가 아니라 클릭한 항목을 저장하고, 입력 칸은 API 입력값 자리가 됩니다.
-
시험하고 승인
작업을 시험 실행한 뒤 승인합니다. 내용이 바뀌면 승인이 풀려 다시 확인해야 합니다.
-
API로 호출
승인된 작업을 HTTP로 호출합니다. 한 번에 한 작업씩 실행하고 결과값을 돌려받습니다.
응답만 보면 무슨 일이 있었는지 압니다
실패하면 어느 단계에서 멈췄는지 알려 주고, 그때의 대상 창 화면을 저장합니다. 기본 주소는 http://127.0.0.1:18787이고 포트는 바꿀 수 있습니다.
| 코드 | 뜻 |
|---|---|
| 200 | 성공. 결과값과 걸린 시간을 돌려줍니다 |
| 400 | 요청 본문이 올바른 JSON이 아닙니다 |
| 401 | 토큰이 맞지 않습니다 |
| 404 | 등록되지 않았거나 승인되지 않은 작업입니다 |
| 422 | 입력 항목이나 형식이 맞지 않습니다 |
| 500 | 실행에 실패했습니다. 멈춘 단계를 알려 줍니다 |
| 503 | 다른 작업이 30초 넘게 실행 중입니다 |
승인한 일만 합니다
임의 명령을 받지 않습니다
실행 파일과 인자는 승인된 작업에 고정됩니다. 입력값은 항목에 글자로만 들어갑니다.
기본은 이 PC에서 온 요청만 받습니다
API는 127.0.0.1에서만 열리고, 호출에는 토큰이 필요합니다. PC 밖에서 호출하려면 유료 외부 호출이 필요합니다.
입력값을 기록하지 않습니다
실행 기록에 입력값과 결과값을 남기지 않고, 녹화 때 키보드 입력도 저장하지 않습니다.
로그인된 화면에서 동작합니다
사용자 화면의 프로그램을 조작하므로 서비스가 아닌 트레이 앱입니다. Windows에 로그인되어 있어야 합니다.
자주 하는 작업 하나부터 연결해 보세요
대상 프로그램이 설치된 PC에 설치합니다.