marketplace

GET /v1/marketplace/vendor/verification/documents/{document_id}/url

A short-lived URL that downloads one identity document.

Усі кінцеві точки marketplace

Уся документація для розробників

Автентифікація

Надішліть ключ API як маркер носія (bearer token). Ця кінцева точка не вказує конкретного дозволу в специфікації, тому надайте своєму ключу мінімально необхідні права та перевірте відповідь, замість того щоб припускати.

Цей кінцевий пункт не потребує ідентифікатора організації. Ваш ключ уже ідентифікує організацію, якій він належить, і відповідь обмежується її межами.

Спробувати

Замініть усе в кутових дужках власними значеннями, а заповнювач ключа — ключем із вашої панелі керування.

curl -X GET https://api.zinndigital.com/v1/marketplace/vendor/verification/documents/{document_id}/url \
  -H "Authorization: Bearer zdk_live_…"

Увійшли в систему? Консоль API у вашій панелі керування автоматично підставляє ваш реальний ідентифікатор організації та ваш власний ключ, а також виконує запит до робочого API, щоб ви могли побачити справжню відповідь. Відкрийте цю кінцеву точку в консолі API

Деталі

⛔⛔ Every view is audit-logged, including the seller's own view of their own passport. docs/82 §7a asks "who looked at this document", and the honest answer includes the account holder — a support agent investigating an account takeover needs to know the documents were pulled, and from which session. The URL carries its own signature and is therefore a credential for its lifetime. Never log it, never store it.

Параметри

НазваТипОбов'язковеЩо це таке
document_id (path)stringТак

Відповідь

НазваТипОбов'язковеЩо це таке
urlstringТакCarries its own signature and is therefore a credential until it expires. Never log it, never store it.
methodstringТак
expires_atstringТак

Помилки, які може повертати ця кінцева точка

401 · 404 · 422