API penjual

Inventaris penjual dan lead write-back disabled pada deployment ini. Pencarian marketplace tetap dinonaktifkan.

marketplace_search — disabled

Autentikasi dan pembayaran

Kirim Authorization: Bearer dengan token seller API. Cakupan grant adalah read, write, dan publish. Grant ruang kerja mencakup inventaris penjual; hak yang hilang adalah 403 not_entitled dan jatah habis adalah 429 quota_exceeded. Grant itu bukan pembayaran MPP. Ketika permukaan mesin mengembalikan 402, coba lagi dengan bearer token yang sama dan Payment-Authorization. Pembayaran tidak pernah mengganti kredensial API. Rahasia tanda tangan webhook tidak dapat mengautentikasi permintaan.

Kontrak HTTP

Create, update, delete, dan publish mengembalikan 200 dengan objek data dan ETag. Penghapusan draf adalah 200 dengan deleted true. Lead write-back adalah POST /api/tenants/{tenant_slug}/leads dan mengembalikan 201. Mutasi mengirim If-Match; prasyarat yang hilang adalah 428 dan yang kedaluwarsa adalah 412. Mengulang reference_code, content_source, dan payload yang sama mengembalikan listing yang sama. Harga memakai amount_minor bilangan bulat dalam mata uang yang dikutip penjual. Temukan pasar, area, bidang, dan mata uang di GET /api/seller/vocabulary. Unggah foto mengembalikan 422 cloudflare_not_configured sampai pengiriman media dikonfigurasi. Publish mengembalikan 422 dengan seller_clearance_required sampai penerimaan penjual berlaku, atau private_owner_quota jika penjual pribadi sudah punya listing aktif. Tarik dengan POST /api/seller/listings/{id}/withdraw; penghapusan non-draf mengembalikan 409 withdraw_instead. Kesalahan lain yang tercantum meliputi 400, 401, dan 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

Webhook

Pengiriman berupa JSON dengan event, listing_id, tenant_id, dan occurred_at, plus header x-tapakly-event dan x-tapakly-signature: sha256= HMAC-SHA256 dari body mentah. Peristiwa kawat adalah listing_created, listing_updated, dan listing_deleted. Peristiwa uji adalah integration_test. Periksa tanda tangan, tandai listing kotor, lalu ambil ulang keadaan API saat ini. Jangan menulis inventaris hanya karena webhook tiba, dan abaikan duplikat, tanda tangan tidak sah, serta peristiwa yang lebih lama setelah Anda mengambil ulang.

Dua resep, satu inventaris

Inventaris yang dikelola Tapakly: baca GET /api/seller/published dan tampilkan di situs Anda. Inventaris yang dikelola CMS: server Anda menulis POST /api/seller/listings dan mempublikasikan ketika penerimaan mengizinkannya. Pilih satu sumber yang berwenang. Sisi lain menampilkan atau menerima; ia tidak menimpa balik.

CLI tapakly

Kelola inventaris penjual dari terminal. Setiap perintah di bawah ada di clients/cli. Gunakan --json untuk catatan mesin yang stabil.

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

Pasang

Belum ada unduhan publik yang diterbitkan. Bangun CLI dari repositori ini:

cd clients/cli
go build -o tapakly .