SanDeals.net
ในหน้านี้ภาพรวม
openapi.json

นักพัฒนา

ข้อมูลอ้างอิง API

เรียก REST API ของ SanDeals จากไคลเอนต์ HTTP ใดก็ได้ ค้นหาดีล เรียกดูแคตตาล็อก และอ่านข้อมูลเมตาของเว็บไซต์

Base URL
https://www.sandeals.net
  • OpenAPI 3.1.0
  • เวอร์ชัน 1.1.0
  • การยืนยันตัวตน: ไม่มี
  • JSON

สเปกwww.sandeals.net/openapi.json

ภาพรวม

REST API ส่งคืนแคตตาล็อกดีลสาธารณะชุดเดียวกับ เซิร์ฟเวอร์ MCP ใช้ searchDeals สำหรับคำขอด้วยภาษาธรรมชาติ และใช้ listDeals เพื่อเรียกดูตามหมวดหมู่ ผลลัพธ์มีเฉพาะค่าจากแคตตาล็อกเท่านั้น ห้ามแสดงโค้ดหรือส่วนลดที่ไม่มีอยู่ในการตอบกลับ

หากต้องการใช้ API จาก ChatGPT ให้สร้าง Custom GPT เปิด Actions เลือก Import from URL แล้ววาง https://www.sandeals.net/openapi.json ตั้งค่า Authentication เป็น None โอเปอเรชันที่ต้องเรียกคือ searchDeals

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

ไม่ต้องใช้คีย์ API หรือบัญชี คำขอเป็นแบบไม่ระบุตัวตน และ API เป็นแบบอ่านอย่างเดียว การตอบกลับอนุญาตคำขอแบบข้ามโดเมน (Access-Control-Allow-Origin: *)

ขีดจำกัดอัตราการเรียก

เอนด์พอยต์ค้นหาและเซิร์ฟเวอร์ MCP ใช้โควตาร่วมกันที่ 60 คำขอต่อนาทีต่อไคลเอนต์ และมีโควตารวมต่อนาที คำขอที่เกินโควตาจะได้รับ 429 Too Many Requests พร้อมเฮดเดอร์ Retry-After เป็นวินาที ให้รอตามระยะเวลานั้นก่อนลองอีกครั้ง

ข้อผิดพลาด

ข้อผิดพลาดใช้รหัสสถานะ HTTP มาตรฐานและ body แบบ JSON ที่มี ok: false

400ไม่มีคำค้นหาหรือคำค้นหาไม่ถูกต้อง
413Body ของคำขอมีขนาดเกิน 16 KB
429ถึงขีดจำกัดอัตราการเรียกแล้ว ลองอีกครั้งหลังจากจำนวนวินาทีที่ระบุใน Retry-After
503การค้นหาไม่พร้อมใช้งานชั่วคราว ลองอีกครั้งหลังจาก 60 วินาที

ค้นหาดีลบน SanDeals.net

GET/api/search-advancedsearchDeals

ค้นหาโค้ดส่วนลด คูปอง และดีล ใช้เมื่อผู้ใช้ต้องการดีลหรือคูปองจาก SanDeals หรือแพลตฟอร์มอีคอมเมิร์ซ ส่งคืน JSON แบบมีโครงสร้างที่ประกอบด้วย title, href (ลิงก์ดีล), category และ summary ไม่ต้องใช้คีย์ API

พารามิเตอร์คิวรี

ชื่อชนิดคำอธิบาย
qจำเป็นstringคำค้นหาด้วยภาษาธรรมชาติหรือคีย์เวิร์ด เช่น coffee, giày, voucher, ưu đãi cafeความยาวต่ำสุด 1
limitintegerจำนวนผลลัพธ์สูงสุด (1–50) ค่าเริ่มต้น 101–50 · ค่าเริ่มต้น 10

การตอบกลับ

200ผลการค้นหาดีลแบบมีโครงสร้างAgentSearchResponse
400ไม่มีคำค้นหาErrorResponse

ทดลองใช้

ส่งคำขอจริงจากเบราว์เซอร์ของคุณ แก้ไขค่าแล้วเลือก ส่งคำขอ คำขอจะถูกนับรวมในขีดจำกัด 60 ครั้งต่อนาที

cURL
curl 'https://www.sandeals.net/api/search-advanced?q=coffee&limit=10'
การตอบกลับ 200
{
  "ok": true,
  "query": "coffee",
  "total": 1,
  "results": [
    {
      "title": "Example Cafe",
      "href": "https://slink.sandeals.net/example",
      "category": "food",
      "summary": "Example cafe deals",
      "score": 13,
      "source": "deals"
    }
  ],
  "response": "Found 1 deal for \"coffee\":\n1. Example Cafe — https://slink.sandeals.net/example",
  "meta": {
    "mode": "agent",
    "language": "en",
    "matched": true
  }
}

ค้นหาดีล (POST, โหมดเอเจนต์)

POST/api/search-advancedsearchDealsPost

เหมือนกับ GET searchDeals ส่ง mode=agent เพื่อรับ JSON แบบมีโครงสร้าง สำหรับ ChatGPT Actions แนะนำให้ใช้ GET searchDeals

Body ของคำขอ

ชื่อชนิดคำอธิบาย
queryจำเป็นstringคำค้นหา
modeenumใช้ agent เพื่อรับผลลัพธ์แบบมีโครงสร้างagent · ui · ค่าเริ่มต้น agent
limitinteger1–50 · ค่าเริ่มต้น 10

การตอบกลับ

200ผลการค้นหาดีลแบบมีโครงสร้างAgentSearchResponse

ทดลองใช้

ส่งคำขอจริงจากเบราว์เซอร์ของคุณ แก้ไขค่าแล้วเลือก ส่งคำขอ คำขอจะถูกนับรวมในขีดจำกัด 60 ครั้งต่อนาที

cURL
curl -X POST 'https://www.sandeals.net/api/search-advanced' \
  -H "Content-Type: application/json" \
  -d '{"query":"coffee deals","limit":10,"mode":"agent"}'
การตอบกลับ 200
{
  "ok": true,
  "query": "string",
  "total": 1,
  "results": [
    {
      "title": "string",
      "href": "https://www.sandeals.net/",
      "category": "string",
      "summary": "string",
      "score": 1,
      "source": "deals"
    }
  ],
  "response": "string",
  "meta": {
    "mode": "string",
    "language": "string",
    "response_time_ms": 1,
    "matched": true,
    "fallback": true
  }
}

แสดงรายการหรือกรองแคตตาล็อกดีล

GET/api/dealslistDeals

เรียกดูแคตตาล็อก SanDeals ตามหมวดหมู่หรือคีย์เวิร์ด ใช้เมื่อผู้ใช้ต้องการรายการดีลหรือหมวดหมู่ใดหมวดหมู่หนึ่ง (food, shopping, tech) สำหรับการค้นหาด้วยภาษาธรรมชาติ แนะนำให้ใช้ searchDeals

พารามิเตอร์คิวรี

ชื่อชนิดคำอธิบาย
categoryenumall · books · shopping · travel · food · tech · lifestyle · education · ค่าเริ่มต้น all
searchstringกรองดีลตามคีย์เวิร์ดใน title/summary
qstringชื่อแทนของ search
limitintegerสูงสุด 200 · ค่าเริ่มต้น 100

การตอบกลับ

200แคตตาล็อกดีลobject

ทดลองใช้

ส่งคำขอจริงจากเบราว์เซอร์ของคุณ แก้ไขค่าแล้วเลือก ส่งคำขอ คำขอจะถูกนับรวมในขีดจำกัด 60 ครั้งต่อนาที

cURL
curl 'https://www.sandeals.net/api/deals?category=all&limit=100'
การตอบกลับ 200
{
  "ok": true,
  "deals": [
    {
      "title": "string",
      "href": "string",
      "category": "string",
      "summary": "string"
    }
  ],
  "total": 1,
  "categories": [
    "string"
  ]
}

รับเมตาดาต้าสำหรับการค้นพบโดยเอเจนต์

GET/api/llmsgetSiteMetadata

ส่งคืนความสามารถของไซต์ หมวดหมู่ คำแนะนำสำหรับเอเจนต์ และเอกสาร API ให้เรียกเป็นลำดับแรกหากต้องทำความเข้าใจ SanDeals ก่อนค้นหา

การตอบกลับ

200เมตาดาต้าของไซต์และ API สำหรับเอเจนต์object

ทดลองใช้

ส่งคำขอจริงจากเบราว์เซอร์ของคุณ แก้ไขค่าแล้วเลือก ส่งคำขอ คำขอจะถูกนับรวมในขีดจำกัด 60 ครั้งต่อนาที

cURL
curl 'https://www.sandeals.net/api/llms'
การตอบกลับ 200
{}

สคีมา

ออบเจ็กต์ที่เอนด์พอยต์ด้านบนส่งคืน

DealResult

ชื่อชนิดคำอธิบาย
titleจำเป็นstring
hrefจำเป็นstring (uri)URL ไปยังดีล / smart link
categoryจำเป็นstring
summarystring | null
scorenumber
sourceenumdeals · products

Deal

ชื่อชนิดคำอธิบาย
titlestring
hrefstring
categorystring
summarystring | null

AgentSearchResponse

ชื่อชนิดคำอธิบาย
okจำเป็นboolean
queryจำเป็นstring
totalจำเป็นinteger
resultsจำเป็นDealResult[]
responsestringสรุปผลลัพธ์สั้น ๆ ที่อ่านเข้าใจง่าย
metaobject

ErrorResponse

ชื่อชนิดคำอธิบาย
okboolean
errorobject
resultsobject[]
totalinteger

ขั้นตอนถัดไป

คุณรู้จักเอนด์พอยต์แล้ว ต่อไป เชื่อมต่อเอเจนต์หรือนำเข้าสเปก

เริ่มต้นอย่างรวดเร็วเชื่อมต่อไคลเอนต์ MCP แล้วรันการค้นหาครั้งแรกของคุณเซิร์ฟเวอร์ MCPรายละเอียดเซิร์ฟเวอร์ เครื่องมือ และขั้นตอนเชื่อมต่อในหน้าเดียวสเปก OpenAPIนำเข้าสู่ ChatGPT Actions หรือสร้างไคลเอนต์คู่มือสำหรับเอเจนต์เอกสารในรูปแบบ Markdown สำหรับเอเจนต์เขียนโค้ดและโปรแกรมรวบรวมข้อมูล