첫 작업을 API로 호출하기까지

설치하기

설치 파일을 실행합니다. API를 계속 받으려면 Windows 로그인 때 자동 실행을 켜 두세요.

창을 닫아도 프로그램은 트레이에서 계속 동작합니다. 다시 열려면 트레이 아이콘을 두 번 클릭하고, 완전히 끄려면 아이콘 메뉴에서 종료를 고릅니다.

작업 녹화하기

대상 프로그램을 미리 열어 두고 녹화 탭으로 갑니다.

1. 작업 이름을 적습니다. 영어 소문자, 숫자, _만 쓸 수 있습니다. 예: add_customer
2. 녹화 시작을 누르고 대상 프로그램을 평소처럼 클릭합니다.
3. 값을 넣을 입력 칸을 클릭하면 API 입력 자리가 됩니다. 이름은 input1, input2 순서로 붙으며 표에서 바꿀 수 있습니다.
4. 결과로 돌려받을 값이 있으면 다음 클릭은 결과로 읽기를 켜고 그 항목을 클릭합니다. 기본 이름은 result입니다.
5. 작업으로 저장을 누릅니다. 잘못 누른 단계는 마지막 단계 지우기로 지웁니다.

키보드 입력은 기록하지 않습니다. 매번 달라지는 값은 입력 칸 클릭으로 API 입력 자리로 만드세요.

시험하고 승인하기

작업 탭에서 방금 저장한 작업을 고릅니다. 상태는 아직 초안입니다.

1. 시험 입력값 칸에 값을 넣습니다.
2. 시험 실행을 누르고 오른쪽 결과를 확인합니다.
3. 결과가 맞으면 승인을 누르고, 확인 창에서 단계 목록을 살펴본 뒤 예를 누릅니다.

{
  "input1": "한빛상사"
}

승인된 작업만 API로 실행됩니다. 작업 내용이 바뀌면 승인이 풀립니다.

토큰 복사하기

설정 탭에서 토큰 복사를 누릅니다. 토큰이 유출됐다면 토큰 새로 만들기를 누르세요. 기존 토큰은 바로 쓸 수 없게 되므로, 호출하는 쪽도 새 토큰으로 바꿔야 합니다.

API로 호출하기

같은 PC에서 실행되는 프로그램이나 스크립트에서 호출합니다. 작업 탭의 API 주소 칸에 작업별 주소가 나옵니다.

PowerShell

$body = [Text.Encoding]::UTF8.GetBytes('{"input1": "한빛상사"}')
Invoke-RestMethod http://127.0.0.1:18787/jobs/add_customer `
  -Method Post -ContentType 'application/json' `
  -Headers @{ Authorization = 'Bearer 복사한_토큰' } -Body $body

Python

import requests

res = requests.post(
    "http://127.0.0.1:18787/jobs/add_customer",
    headers={"Authorization": "Bearer 복사한_토큰"},
    json={"input1": "한빛상사"},
    timeout=120,
)
print(res.status_code, res.json())

성공 응답

{"outputs": {"result": "C-1024"}, "ms": 1840}

프로그램이 켜져 있는지는 GET /health로 토큰 없이 확인합니다. 등록된 작업 목록은 토큰을 넣어 GET /jobs로 조회합니다.