Verkäufer-API

Verkäuferbestand und Lead-Rückschreiben sind disabled auf diesem Deployment. Die Marktplatzsuche bleibt ausgeschaltet.

marketplace_search — disabled

Authentifizierung und Zahlung

Senden Sie Authorization: Bearer mit einem Seller-API-Token. Grant-Bereiche sind read, write und publish. Ein Arbeitsbereichs-Grant deckt den Verkäuferbestand; fehlendes Recht ist 403 not_entitled, aufgebrauchtes Kontingent ist 429 quota_exceeded. Dieser Grant ist keine MPP-Zahlung. Wenn eine Maschinenfläche 402 liefert, wiederholen Sie mit demselben Bearer-Token und Payment-Authorization. Zahlung ersetzt nie die API-Anmeldedaten. Webhook-Signaturgeheimnisse können Anfragen nicht authentifizieren.

HTTP-Vertrag

Create, update, delete und publish liefern 200 mit einem data-Objekt und einem ETag. Das Löschen eines Entwurfs ist 200 mit deleted true. Lead-Rückschreiben ist POST /api/tenants/{tenant_slug}/leads und liefert 201. Mutationen senden If-Match; eine fehlende Vorbedingung ist 428, eine veraltete 412. Dieselbe reference_code, content_source und payload liefern dasselbe Inserat. Preise nutzen ganzzahlige amount_minor in der Währung, die der Verkäufer nennt. Märkte, Gebiete, Felder und Währungen stehen unter GET /api/seller/vocabulary. Foto-Upload liefert 422 cloudflare_not_configured, bis die Medienauslieferung eingerichtet ist. Publish liefert 422 mit seller_clearance_required, bis die Verkäuferzulassung aktuell ist, oder private_owner_quota, wenn ein privater Verkäufer schon ein aktives Inserat hat. Zurückziehen mit POST /api/seller/listings/{id}/withdraw; das Löschen eines Nicht-Entwurfs liefert 409 withdraw_instead. Weitere aufgeführte Fehler sind 400, 401 und 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

Webhooks

Zustellungen sind JSON mit event, listing_id, tenant_id und occurred_at sowie den Headern x-tapakly-event und x-tapakly-signature: sha256= HMAC-SHA256 des Rohkörpers. Draht-Ereignisse sind listing_created, listing_updated und listing_deleted. Ein Test-Ereignis ist integration_test. Prüfen Sie die Signatur, markieren Sie das Inserat als unsauber und holen Sie den aktuellen API-Stand neu. Schreiben Sie den Bestand nicht, nur weil ein Webhook ankam, und ignorieren Sie Duplikate, ungültige Signaturen und ältere Ereignisse, nachdem Sie neu geladen haben.

Zwei Rezepte, ein Bestand

Von Tapakly geführter Bestand: lesen Sie GET /api/seller/published und rendern Sie ihn auf Ihrer Site. Von CMS geführter Bestand: Ihr Server schreibt POST /api/seller/listings und veröffentlicht, wenn die Zulassung es erlaubt. Wählen Sie eine maßgebliche Quelle. Die andere Seite zeigt an oder empfängt; sie überschreibt nicht zurück.

tapakly CLI

Steuern Sie den Verkäuferbestand von einem Terminal. Jeder Befehl unten existiert in clients/cli. Übergeben Sie --json für einen stabilen Maschinen-Datensatz.

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

Installieren

Es ist noch kein öffentlicher Download veröffentlicht. Bauen Sie die CLI aus diesem Repository:

cd clients/cli
go build -o tapakly .