ดูสถานะ Job

ดึงสถานะปัจจุบัน (และผลลัพธ์เมื่อเสร็จ) ของ async verify job ด้วย jobId ใช้เมื่อรับ webhook ไม่ได้ หรือเพื่อกระทบยอดผลที่อาจพลาดไป

Endpoint

GET /verify/bank/jobs/:jobId

URL เต็ม: https://api-partners.easyslip.com/v2/verify/bank/jobs/{jobId}

การยืนยันตัวตน

จำเป็น ใช้ HMAC-SHA256 กับ Branch UUID เป็น X-API-Key ดูคู่มือ Authentication

X-API-Key: YOUR_BRANCH_UUID
X-Timestamp: 1700000000
X-Nonce: 550e8400-e29b-41d4-a716-446655440000
X-Signature: HMAC_SHA256_SIGNATURE

Request

Path Parameters

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
jobId	string	ใช่	UUID ที่คืนจาก POST /verify/bank/async หรือ /batch

Job อ่านได้เฉพาะ branch ที่สร้างเท่านั้น jobId ของ branch อื่นจะได้ 404 JOB_NOT_FOUND เหมือนกับที่ไม่มีอยู่จริง (ป้องกันการไล่เดา job ID ข้าม branch)

Type Definitions

type JobStatus = 'queued' | 'processing' | 'retrying' | 'done' | 'failed';

// Response
interface JobStatusResponse {
  success: true;
  data: {
    jobId: string;
    status: JobStatus;
    attempts: number;         // จำนวนครั้งที่พยายามประมวลผล
    batchId?: string | null;  // มีเมื่อ job ถูกส่งผ่าน /batch
    result?: VerifyBankData;  // มีเมื่อ status เป็น 'done' (shape เดียวกับ sync verify)
    error?: unknown;          // มีเมื่อ status เป็น 'failed'
  };
  message: string;
}

Job record เก็บไว้ 7 วัน หลังสร้าง จากนั้นจะหมดอายุ

ตัวอย่าง

cURL

curl https://api-partners.easyslip.com/v2/verify/bank/jobs/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: YOUR_BRANCH_UUID" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Nonce: ${NONCE}" \
  -H "X-Signature: ${SIGNATURE}"

JavaScript

const getJob = async (jobId) => {
  const path = `/verify/bank/jobs/${jobId}`;
  const response = await fetch(`https://api-partners.easyslip.com/v2${path}`, {
    method: 'GET',
    headers: signRequest({ method: 'GET', path, apiKey: 'YOUR_BRANCH_UUID', secretKey: 'YOUR_SECRET_KEY' })
  });

  const result = await response.json();
  if (!result.success) throw new Error(result.error.message);

  return result.data; // { jobId, status, result?, ... }
};

// poll จนกว่า job จะเสร็จ
const waitForJob = async (jobId, { intervalMs = 2000, timeoutMs = 60000 } = {}) => {
  const deadline = Date.now() + timeoutMs;
  while (Date.now() < deadline) {
    const job = await getJob(jobId);
    if (job.status === 'done') return job.result;
    if (job.status === 'failed') throw new Error('Verification failed');
    await new Promise((r) => setTimeout(r, intervalMs));
  }
  throw new Error('Timed out waiting for job');
};

TypeScript

type JobStatus = 'queued' | 'processing' | 'retrying' | 'done' | 'failed';

async function getJob(jobId: string) {
  const path = `/verify/bank/jobs/${jobId}`;
  const response = await fetch(`https://api-partners.easyslip.com/v2${path}`, {
    method: 'GET',
    headers: signRequest({ method: 'GET', path, apiKey: process.env.EASYSLIP_API_KEY!, secretKey: process.env.EASYSLIP_SECRET_KEY! })
  });

  const result = await response.json();
  if (!result.success) throw new Error(result.error?.message || 'Failed to fetch job');

  return result.data as { jobId: string; status: JobStatus; attempts: number; result?: unknown; error?: unknown };
}

PHP

function getJob(string $jobId): array
{
    $path = "/verify/bank/jobs/{$jobId}";

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => "https://api-partners.easyslip.com/v2{$path}",
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            // ใช้ helper signRequest() - ดูคู่มือ Authentication
        ]
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    $result = json_decode($response, true);
    if (!$result['success']) {
        throw new Exception($result['error']['message']);
    }

    return $result['data'];
}

Python

import requests
import os

def get_job(job_id: str) -> dict:
    path = f'/verify/bank/jobs/{job_id}'
    response = requests.get(
        f'https://api-partners.easyslip.com/v2{path}',
        headers=sign_request('GET', path, None, os.environ['EASYSLIP_API_KEY'], os.environ['EASYSLIP_SECRET_KEY'])
    )

    result = response.json()
    if not result['success']:
        raise Exception(result['error']['message'])

    return result['data']

Response

Queued / Processing (200)

{
  "success": true,
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "processing",
    "attempts": 1
  },
  "message": "OK"
}

Done (200)

{
  "success": true,
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "done",
    "attempts": 1,
    "result": {
      "isDuplicate": false,
      "rawSlip": {
        "transRef": "68370160657749I376388B35",
        "amount": { "amount": 1500.00, "local": { "amount": 1500.00, "currency": "THB" } },
        "sender": { "bank": { "id": "004", "short": "KBANK" } },
        "receiver": { "bank": { "id": "014", "short": "SCB" } }
      }
    }
  },
  "message": "OK"
}

object result มี shape เดียวกับ data ของPOST /verify/bank แบบ synchronous

Failed (200)

{
  "success": true,
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "failed",
    "attempts": 3,
    "error": { "code": "SLIP_NOT_FOUND", "message": "The slip could not be found or is invalid" }
  },
  "message": "OK"
}

Error Responses

ไม่พบ Job (404)

{
  "success": false,
  "error": {
    "code": "JOB_NOT_FOUND",
    "message": "Job 550e8400-e29b-41d4-a716-446655440000 not found"
  }
}

ได้ทั้งเมื่อ jobId ไม่มีอยู่จริง และเมื่อเป็นของ branch อื่น

หมายเหตุ

• ค่าสถานะ: queued → processing → done; ถ้าล้มเหลวชั่วคราวจะเป็น retrying และถ้าล้มเหลวถาวรจะจบที่ failed
• แนะนำให้ใช้webhook เป็นหลัก ใช้ polling เป็นทางเลือกสำรองหรือกระทบยอด
• Job record หมดอายุ 7 วัน หลังสร้าง