เอกสาร Public API

curl -s "https://api.homes.in.th/api/public/v1/properties?page=1&limit=10&listingType=FOR_SALE" \
  -H "Authorization: Bearer $HOMES_API_KEY"

curl -s -X POST "https://api.homes.in.th/api/public/v1/properties" \
  -H "Authorization: Bearer $HOMES_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "property": {
      "title": "คอนโด 1 ห้องนอน สุขุมวิท 21 ใกล้ MRT สุขุมวิท",
      "description": "ห้องมุม ชั้น 12 วิวเมือง ตกแต่งครบ พร้อมเข้าอยู่",
      "propertyType": "RESIDENTIAL",
      "listingType": "FOR_SALE",
      "announcerStatus": "AGENT",
      "price": "4500000"
    },
    "address": {
      "streetAddress": "ซอยสุขุมวิท 21 (อโศก) ถนนสุขุมวิท",
      "latitude": 13.7372, "longitude": 100.5611,
      "subDistrictId": 100402, "postalCodeId": 10110
    },
    "residential": { "residentialType": "CONDO", "usableArea": 35, "floor": 12, "bedroom": 1, "bathroom": 1 }
  }'

import { randomUUID } from "node:crypto";

const BASE = "https://api.homes.in.th/api/public/v1";
const KEY = process.env.HOMES_API_KEY;
if (!KEY) throw new Error("HOMES_API_KEY is not set");

async function call(method, path, { body, headers } = {}) {
  const res = await fetch(BASE + path, {
    method,
    headers: {
      Authorization: `Bearer ${KEY}`,
      ...(body ? { "Content-Type": "application/json" } : {}),
      ...headers,
    },
    body: body ? JSON.stringify(body) : undefined,
  });
  if (res.status === 204) return null;
  const json = await res.json();
  if (json.error) {
    // ตัดสินใจจาก error.code เสมอ ไม่ใช่ message
    throw Object.assign(new Error(json.error.message), { code: json.error.code, status: res.status });
  }
  return json.data;
}

// 1) ดึงรายการประกาศ
const list = await call("GET", "/properties?page=1&limit=10&listingType=FOR_SALE");
console.log(list.meta.paginate.total, "listings");

// 2) สร้างประกาศ (Idempotency-Key ใช้ซ้ำได้เมื่อ retry คำขอเดิม)
const idem = randomUUID();
const created = await call("POST", "/properties", {
  headers: { "Idempotency-Key": idem },
  body: {
    property: {
      title: "คอนโด 1 ห้องนอน สุขุมวิท 21 ใกล้ MRT สุขุมวิท",
      description: "ห้องมุม ชั้น 12 วิวเมือง ตกแต่งครบ พร้อมเข้าอยู่",
      propertyType: "RESIDENTIAL",
      listingType: "FOR_SALE",
      announcerStatus: "AGENT",
      price: "4500000",
    },
    address: {
      streetAddress: "ซอยสุขุมวิท 21 (อโศก) ถนนสุขุมวิท",
      latitude: 13.7372, longitude: 100.5611,
      subDistrictId: 100402, postalCodeId: 10110,
    },
    residential: { residentialType: "CONDO", usableArea: 35, floor: 12, bedroom: 1, bathroom: 1 },
  },
});
console.log("created", created.shownId, created.status);

<?php
$base = 'https://api.homes.in.th/api/public/v1';
$key  = getenv('HOMES_API_KEY') ?: throw new RuntimeException('HOMES_API_KEY is not set');

function homes(string $method, string $path, ?array $body = null, array $headers = []): ?array {
    global $base, $key;
    $h = array_merge(["Authorization: Bearer $key"], $headers);
    if ($body !== null) $h[] = 'Content-Type: application/json';
    $ch = curl_init($base . $path);
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST  => $method,
        CURLOPT_HTTPHEADER     => $h,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 15,
        CURLOPT_POSTFIELDS     => $body !== null ? json_encode($body, JSON_UNESCAPED_UNICODE) : null,
    ]);
    $raw    = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    curl_close($ch);
    if ($status === 204) return null;
    $json = json_decode($raw, true);
    if (!empty($json['error'])) {
        // เขียนเงื่อนไขจาก error.code
        throw new RuntimeException($json['error']['code'] . ': ' . $json['error']['message'], $status);
    }
    return $json['data'];
}

// 1) ดึงรายการประกาศ
$list = homes('GET', '/properties?page=1&limit=10&listingType=FOR_SALE');
echo $list['meta']['paginate']['total'], " listings\n";

// 2) สร้างประกาศพร้อม Idempotency-Key
$idem = bin2hex(random_bytes(16));
$created = homes('POST', '/properties', [
    'property' => [
        'title'           => 'คอนโด 1 ห้องนอน สุขุมวิท 21 ใกล้ MRT สุขุมวิท',
        'description'     => 'ห้องมุม ชั้น 12 วิวเมือง ตกแต่งครบ พร้อมเข้าอยู่',
        'propertyType'    => 'RESIDENTIAL',
        'listingType'     => 'FOR_SALE',
        'announcerStatus' => 'AGENT',
        'price'           => '4500000',
    ],
    'address' => [
        'streetAddress' => 'ซอยสุขุมวิท 21 (อโศก) ถนนสุขุมวิท',
        'latitude' => 13.7372, 'longitude' => 100.5611,
        'subDistrictId' => 100402, 'postalCodeId' => 10110,
    ],
    'residential' => ['residentialType' => 'CONDO', 'usableArea' => 35, 'floor' => 12, 'bedroom' => 1, 'bathroom' => 1],
], ["Idempotency-Key: $idem"]);
echo 'created ', $created['shownId'], ' ', $created['status'], "\n";