ดาวน์โหลดรายงานสถานะแบบกลุ่ม

GEThttps://api.omise.co/recurring_exports/:recurring_id/download

ดาวน์โหลดรายงานสถานะโดยละเอียดสำหรับงานสร้างกำหนดการเรียกเก็บเงินแบบกลุ่มที่เสร็จสมบูรณ์ รายงานประกอบด้วยข้อมูล CSV ดั้งเดิมพร้อมคอลัมน์เพิ่มเติมที่แสดงสถานะการสร้างและข้อความข้อผิดพลาดสำหรับแต่ละแถว

---

🔑ข้อมูลยืนยันตัวตน API

▼

---

พารามิเตอร์คำขอ

จำเป็น - 1 ฟิลด์พารามิเตอร์พาธ

▼

`recurring_id`STRING(required)

Recurring export ID ที่ได้รับจาก endpoint การสร้างแบบกลุ่ม IDs เริ่มต้นด้วย recr_ งานต้องอยู่ในสถานะ "completed"

Example:"recr_test_5xuy4w91xqz7d1w9u0t"

---

การตอบกลับ

200

ดาวน์โหลดรายงานสำเร็จ

ส่งคืนไฟล์ CSV ที่มีรายงานสถานะ Content-Type ของการตอบกลับคือ text/csv

คอลัมน์ CSV ประกอบด้วย:

• คอลัมน์ดั้งเดิมทั้งหมดจาก CSV ที่อัปโหลด
• status - สถานะการประมวลผลแถว (success หรือ failed)
• schedule_id - Schedule ID ที่สร้าง (schd_*) สำหรับแถวที่สำเร็จ
• error_code - รหัสข้อผิดพลาดสำหรับแถวที่ล้มเหลว
• error_message - คำอธิบายข้อผิดพลาดโดยละเอียดสำหรับแถวที่ล้มเหลว

ตัวอย่างผลลัพธ์:

customer_key,customer,card,amount,description,every,period,days_of_month,start_date,end_date,status,schedule_id,error_code,error_message
sub_001,cust_test_abc123,,100000,Monthly plan,1,month,1,2025-02-01,2026-01-31,success,schd_test_xyz789,,
sub_002,cust_test_invalid,,50000,Basic plan,1,month,15,2025-02-01,,failed,,invalid_customer,Customer not found

400

คำขอไม่ถูกต้อง

การตรวจสอบคำขอล้มเหลว ตรวจสอบข้อความข้อผิดพลาดสำหรับรายละเอียด

สาเหตุทั่วไป:

• รูปแบบ recurring_id ไม่ถูกต้อง
• งานยังไม่เสร็จสมบูรณ์ (ยังอยู่ในสถานะ pending หรือ processing)

401

ไม่ได้รับอนุญาต

การยืนยันตัวตนล้มเหลว API key ไม่ถูกต้องหรือหายไป

สาเหตุทั่วไป:

• ไม่มี Authorization header
• Secret key ไม่ถูกต้อง
• ใช้ public key แทน secret key
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

ไม่พบ

ไม่พบงานสร้างแบบกลุ่มหรือรายงานไม่พร้อมใช้งาน

สาเหตุทั่วไป:

• recurring_id ไม่ถูกต้อง
• งานเป็นของบัญชีอื่น
• ใช้คีย์โหมด test และ live ปนกัน
• รายงานหมดอายุแล้ว (เก่ากว่า 30 วัน)

5xx

ข้อผิดพลาดเซิร์ฟเวอร์

เกิดข้อผิดพลาดฝั่งเซิร์ฟเวอร์ เหตุการณ์เหล่านี้หายากแต่ควรจัดการอย่างเหมาะสม

วิธีจัดการ:

• ลองคำขอใหม่ด้วย exponential backoff
• ตรวจสอบ status.omise.co สำหรับเหตุการณ์บริการ
• ดู การจัดการข้อผิดพลาด สำหรับคำแนะนำโดยละเอียด

---

ตัวอย่างโค้ด

cURL

# ดาวน์โหลดรายงานสถานะการสร้างแบบกลุ่ม
curl https://api.omise.co/recurring_exports/recr_test_5xuy4w91xqz7d1w9u0t/download \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -o status_report.csv

Ruby

require 'omise'
require 'net/http'
require 'uri'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

recurring_id = 'recr_test_5xuy4w91xqz7d1w9u0t'

uri = URI("https://api.omise.co/recurring_exports/#{recurring_id}/download")
request = Net::HTTP::Get.new(uri)
request.basic_auth(Omise.api_key, '')

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

# บันทึกเป็นไฟล์
File.open('status_report.csv', 'w') do |file|
  file.write(response.body)
end

puts "Report saved to status_report.csv"

Python

import omise
import requests

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

recurring_id = 'recr_test_5xuy4w91xqz7d1w9u0t'

response = requests.get(
    f'https://api.omise.co/recurring_exports/{recurring_id}/download',
    auth=(omise.api_secret, '')
)

# บันทึกเป็นไฟล์
with open('status_report.csv', 'wb') as f:
    f.write(response.content)

print("Report saved to status_report.csv")

# หรือ parse และประมวลผล CSV
import csv
import io

reader = csv.DictReader(io.StringIO(response.text))
for row in reader:
    if row['status'] == 'failed':
        print(f"Failed: {row['customer_key']} - {row['error_message']}")

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});
const axios = require('axios');
const fs = require('fs');

const recurringId = 'recr_test_5xuy4w91xqz7d1w9u0t';

const response = await axios.get(
  `https://api.omise.co/recurring_exports/${recurringId}/download`,
  {
    auth: {
      username: 'skey_test_5xuy4w91xqz7d1w9u0t',
      password: ''
    },
    responseType: 'text'
  }
);

// บันทึกเป็นไฟล์
fs.writeFileSync('status_report.csv', response.data);
console.log('Report saved to status_report.csv');

// หรือ parse และประมวลผล
const Papa = require('papaparse');
const parsed = Papa.parse(response.data, { header: true });

parsed.data.forEach(row => {
  if (row.status === 'failed') {
    console.log(`Failed: ${row.customer_key} - ${row.error_message}`);
  }
});

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$recurring_id = 'recr_test_5xuy4w91xqz7d1w9u0t';

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.omise.co/recurring_exports/{$recurring_id}/download",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD => OMISE_SECRET_KEY . ':'
]);

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

// บันทึกเป็นไฟล์
file_put_contents('status_report.csv', $response);
echo "Report saved to status_report.csv\n";

// หรือ parse และประมวลผล
$lines = explode("\n", $response);
$header = str_getcsv(array_shift($lines));

foreach ($lines as $line) {
    if (empty($line)) continue;
    $row = array_combine($header, str_getcsv($line));
    if ($row['status'] === 'failed') {
        echo "Failed: {$row['customer_key']} - {$row['error_message']}\n";
    }
}

Java

import java.io.FileOutputStream;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;

HttpClient client = HttpClient.newHttpClient();

String recurringId = "recr_test_5xuy4w91xqz7d1w9u0t";
String auth = Base64.getEncoder().encodeToString("skey_test_5xuy4w91xqz7d1w9u0t:".getBytes());

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.omise.co/recurring_exports/" + recurringId + "/download"))
    .header("Authorization", "Basic " + auth)
    .GET()
    .build();

HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());

// บันทึกเป็นไฟล์
try (FileOutputStream fos = new FileOutputStream("status_report.csv")) {
    fos.write(response.body());
}

System.out.println("Report saved to status_report.csv");

C#

using System.Net.Http;
using System.Net.Http.Headers;
using System.IO;

var client = new HttpClient();

var credentials = Convert.ToBase64String(
    System.Text.Encoding.ASCII.GetBytes("skey_test_5xuy4w91xqz7d1w9u0t:")
);
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Basic", credentials);

var recurringId = "recr_test_5xuy4w91xqz7d1w9u0t";
var response = await client.GetAsync(
    $"https://api.omise.co/recurring_exports/{recurringId}/download"
);
var content = await response.Content.ReadAsByteArrayAsync();

// บันทึกเป็นไฟล์
await File.WriteAllBytesAsync("status_report.csv", content);
Console.WriteLine("Report saved to status_report.csv");

Go

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    recurringId := "recr_test_5xuy4w91xqz7d1w9u0t"

    req, _ := http.NewRequest("GET",
        "https://api.omise.co/recurring_exports/"+recurringId+"/download", nil)
    req.SetBasicAuth("skey_test_5xuy4w91xqz7d1w9u0t", "")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    // บันทึกเป็นไฟล์
    file, _ := os.Create("status_report.csv")
    defer file.Close()
    io.Copy(file, resp.Body)

    fmt.Println("Report saved to status_report.csv")
}

---

การประมวลผลรายงานสถานะ

หลังจากดาวน์โหลดรายงาน คุณสามารถประมวลผลเพื่อจัดการแถวที่ล้มเหลว:

import csv

def process_status_report(filepath):
    successful = []
    failed = []

    with open(filepath, 'r') as f:
        reader = csv.DictReader(f)
        for row in reader:
            if row['status'] == 'success':
                successful.append({
                    'customer_key': row['customer_key'],
                    'schedule_id': row['schedule_id']
                })
            else:
                failed.append({
                    'customer_key': row['customer_key'],
                    'error_code': row['error_code'],
                    'error_message': row['error_message']
                })

    print(f"Successful: {len(successful)}")
    print(f"Failed: {len(failed)}")

    # ลองแถวที่ล้มเหลวใหม่หรือแจ้งทีมที่เกี่ยวข้อง
    for fail in failed:
        print(f"  - {fail['customer_key']}: {fail['error_message']}")

    return successful, failed

successful, failed = process_status_report('status_report.csv')

---

รหัสข้อผิดพลาดและผลลัพธ์

ค่าสถานะแถว

สถานะ	คำอธิบาย
success	สร้างกำหนดการสำเร็จ
failed	การสร้างกำหนดการล้มเหลว

รหัสข้อผิดพลาดทั่วไปในรายงาน

รหัส	คำอธิบาย	การแก้ไข
invalid_customer	ไม่พบ Customer ID	ตรวจสอบว่าลูกค้ามีอยู่และใช้งานอยู่
no_card_attached	ลูกค้าไม่มีบัตรชำระเงิน	แนบบัตรให้ลูกค้า
invalid_card	ไม่พบ Card ID หรือหมดอายุ	ใช้บัตรที่ถูกต้องหรือลบออกเพื่อใช้ค่าเริ่มต้น
invalid_amount	จำนวนเงินเป็นศูนย์ ติดลบ หรือไม่ถูกต้อง	ระบุจำนวนเงินเป็นจำนวนเต็มบวก
invalid_period	ไม่รู้จักค่า period	ใช้ day, week, หรือ month
invalid_days_of_month	ค่าวันไม่ถูกต้อง	ใช้ค่า 1-28
invalid_date_format	ไม่รู้จักรูปแบบวันที่	ใช้รูปแบบ YYYY-MM-DD
start_date_in_past	วันที่เริ่มต้นอยู่ในอดีต	ใช้วันที่ปัจจุบันหรืออนาคต
end_date_before_start	วันที่สิ้นสุดอยู่ก่อนวันที่เริ่มต้น	ตรวจสอบว่าวันที่สิ้นสุดอยู่หลังวันที่เริ่มต้น
duplicate_schedule	มีกำหนดการสำหรับลูกค้าแล้ว	ตรวจสอบกำหนดการที่มีอยู่

---

ลองใช้งาน

จำเป็น - 1 ฟิลด์

▼

recurring_id(จำเป็น)

IP ของคุณ: ...กำลังโหลด...