marketplace

POST `/v1/marketplace/vendor/verification/documents`

Reserve a document slot and get a short-lived upload URL.

Tous les points de terminaison marketplace

Authentification

Envoyez une clé d'API en tant que jeton du porteur (bearer token). Cet endpoint n'indique pas de permission spécifique dans la spécification, attribuez donc à votre clé le minimum requis et vérifiez la réponse plutôt que de faire des suppositions.

Cet endpoint ne prend aucun identifiant d'organisation. Votre clé identifie déjà l'organisation à laquelle elle appartient, et la réponse y est limitée.

Essayer

Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau de bord.

curl -X POST https://api.zinndigital.com/v1/marketplace/vendor/verification/documents \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "kind": <MarketplaceDocumentKind>, "filename": <string>, "content_type": <string<image/jpeg, image/png, application/pdf>>, "size_bytes": <integer> }'

Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API

Détails

docs/82 §7a. **The bytes never pass through the engine.** The response carries a presigned `PUT` the browser uploads straight to object storage with; a 10 MB scan routed through an API worker is 10 MB of a request thread and a request that outlives its timeout on a poor connection. ⛔ The stored object key is deliberately absent from the response — the seller needs the signed URL, never the address of an object in a bucket of identity documents. ⛔ **We ask for "a government-issued photo ID"** — passport, national identity card, driving licence or residence permit — and there is no country list. A student, workplace or library card is not government-issued and is not accepted.

Corps de la requête

Nom	Type	Obligatoire	Qu'est-ce que c'est
`kind`	`MarketplaceDocumentKind`	Oui	What a stored object is evidence of. `photo_id` covers passport, national identity card, driving licence and residence permit — there is no country list, and a student, workplac…
`subject_id`	`string`	Non	Required for `photo_id` and `proof_of_address` — a personal document with no person satisfies nobody's requirement while looking uploaded on every screen.
`filename`	`string`	Oui	—
`content_type`	`string<image/jpeg, image/png, application/pdf>`	Oui	JPEG, PNG or PDF. An allow-list, not a deny-list.
`size_bytes`	`integer`	Oui	—

Réponse

Nom	Type	Obligatoire	Qu'est-ce que c'est
`document`	`MarketplaceVerificationDocument`	Oui	A pointer to one uploaded document. The bytes live in object storage and are reached only through a short-lived signed URL; the object key is never published.
`upload`	`MarketplaceDocumentUploadGrant`	Oui	A presigned upload. The `headers` are part of the grant, not decoration — a signature computed over `content-type` fails with a 403 if the uploader omits it.

Erreurs que cet point de terminaison peut renvoyer

401 · 404 · 422

POST /v1/marketplace/vendor/verification/documents