API ผู้ขาย

คลังผู้ขายและการเขียนกลับลีด disabled บนการติดตั้งนี้ การค้นหาตลาดยังปิดอยู่

marketplace_search — disabled

การยืนยันตัวตนและการชำระเงิน

ส่ง Authorization: Bearer พร้อมโทเค็น seller API ขอบเขต grant คือ read, write และ publish grant ของพื้นที่ทำงานครอบคลุมคลังผู้ขาย หากไม่มีสิทธิ์ได้ 403 not_entitled และโควตาหมดได้ 429 quota_exceeded grant นั้นไม่ใช่การชำระ MPP เมื่อพื้นผิวเครื่องคืน 402 ให้ลองใหม่ด้วย bearer token เดิมและ Payment-Authorization การชำระเงินไม่แทนที่ข้อมูลรับรอง API ความลับลายเซ็น webhook ยืนยันคำขอไม่ได้

สัญญา HTTP

Create, update, delete และ publish คืน 200 พร้อมอ็อบเจ็กต์ data และ ETag การลบฉบับร่างคือ 200 พร้อม deleted true การเขียนกลับลีดคือ POST /api/tenants/{tenant_slug}/leads และคืน 201 การแก้ไขส่ง If-Match หากไม่มีเงื่อนไขล่วงหน้าได้ 428 ของเก่าได้ 412 การใช้ reference_code, content_source และ payload เดิมคืนประกาศเดิม ราคาใช้ amount_minor เป็นจำนวนเต็มในสกุลที่ผู้ขายเสนอ ค้นหาตลาด พื้นที่ ฟิลด์ และสกุลเงินที่ GET /api/seller/vocabulary การอัปโหลดรูปคืน 422 cloudflare_not_configured จนกว่าจะตั้งค่าการส่งสื่อ Publish คืน 422 พร้อม seller_clearance_required จนกว่าการรับผู้ขายจะเป็นปัจจุบัน หรือ private_owner_quota เมื่อผู้ขายส่วนบุคคลมีประกาศที่ใช้งานอยู่แล้ว ถอนด้วย POST /api/seller/listings/{id}/withdraw การลบที่ไม่ใช่ฉบับร่างคืน 409 withdraw_instead ข้อผิดพลาดอื่นที่ระบุ ได้แก่ 400, 401 และ 404

get /api/seller/listings	200, 400, 401, 403, 404, 429 — disabled
post /api/seller/listings	200, 400, 401, 403, 404, 409, 422, 429 — disabled
delete /api/seller/listings/{id}	200, 400, 401, 403, 404, 409, 412, 422, 428, 429 — disabled
get /api/seller/listings/{id}	200, 400, 401, 403, 404, 429 — disabled
patch /api/seller/listings/{id}	200, 400, 401, 403, 404, 412, 422, 428, 429 — disabled
post /api/seller/listings/{id}/photos	200, 400, 401, 403, 404, 412, 422, 428, 429 — disabled
delete /api/seller/listings/{id}/photos/{photo_id}	200, 400, 401, 403, 404, 412, 422, 428, 429 — disabled
patch /api/seller/listings/{id}/photos/{photo_id}	200, 400, 401, 403, 404, 412, 422, 428, 429 — disabled
post /api/seller/listings/{id}/photos/{photo_id}/complete	200, 400, 401, 403, 404, 412, 422, 428, 429 — disabled
post /api/seller/listings/{id}/publish	200, 400, 401, 403, 404, 412, 422, 428, 429 — disabled
post /api/seller/listings/{id}/withdraw	200, 400, 401, 403, 404, 412, 422, 428, 429 — disabled
get /api/seller/published	200, 400, 401, 403, 404, 429 — disabled
get /api/seller/published/{id}	200, 400, 401, 403, 404, 429 — disabled
get /api/seller/vocabulary	200, 400, 401, 403, 404, 429 — disabled
post /api/tenants/{tenant_slug}/leads	201, 404, 422 — disabled

เว็บฮุก

การส่งเป็น JSON มี event, listing_id, tenant_id และ occurred_at พร้อมส่วนหัว x-tapakly-event และ x-tapakly-signature: sha256= HMAC-SHA256 ของเนื้อหาดิบ เหตุการณ์สายคือ listing_created, listing_updated และ listing_deleted เหตุการณ์ทดสอบคือ integration_test ตรวจลายเซ็น ทำเครื่องหมายประกาศว่าสกปรก แล้วดึงสถานะ API ปัจจุบันอีกครั้ง อย่าเขียนคลังเพียงเพราะ webhook มาถึง และละเว้นรายการซ้ำ ลายเซ็นไม่ถูกต้อง และเหตุการณ์ที่เก่ากว่าหลังจากดึงใหม่แล้ว

สองสูตร หนึ่งคลัง

คลังที่ Tapakly จัดการ: อ่าน GET /api/seller/published แล้วแสดงบนไซต์คุณ คลังที่ CMS จัดการ: เซิร์ฟเวอร์คุณเขียน POST /api/seller/listings และเผยแพร่เมื่อการรับอนุญาต เลือกแหล่งหลักแหล่งเดียว ฝั่งอื่นแสดงหรือรับ ไม่เขียนทับกลับ

tapakly CLI

จัดการคลังผู้ขายจากเทอร์มินัล ทุกคำสั่งด้านล่างมีใน clients/cli ส่ง --json เพื่อบันทึกเครื่องที่เสถียร

tapakly vocabulary
tapakly listings list
tapakly listings show
tapakly listings create
tapakly listings update
tapakly listings publish
tapakly listings withdraw
tapakly listings delete
tapakly photos upload
tapakly published
tapakly auth set

ติดตั้ง

ยังไม่มีการเผยแพร่ไฟล์ดาวน์โหลดสาธารณะ สร้าง CLI จากที่เก็บนี้:

cd clients/cli
go build -o tapakly .