pbs-library
POST /v1/pbs-library/sessions
Start a cloud-library session for a licensed site.
Аутентификација
Ова крајња тачка је јавна. Не захтева никакве акредитиве нити организацију — то је оно што читају наш сопствени маркетиншки сајт и машине за одговоре са вештачком интелигенцијом.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/pbs-library/sessions \
-H "Content-Type: application/json" \
-d '{ "product": <string<page-builder-sandwich>>, "install_id": <string>, "license_id": <string>, "site_url": <string>, "timestamp": <integer>, "nonce": <string>, "signature": <string> }'Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Called server-side by Page Builder Sandwich. The request is signed with the site's licensing install secret key: signature = hex(HMAC-SHA256(install_secret_key, "zinn-pbs-library/v1\n{product}\n{install_id}\n{license_id}\n{site_url}\n{timestamp}\n{nonce}")). The engine reads the install from the licensing vendor with the product's keys, recomputes the signature, and checks the licence (active, this product, a paid plan). A proof older than 5 minutes (proof_expired) or seen before (proof_replayed) is 401; a wrong signature or a lapsed licence 403 licence_refused; a free plan 403 pro_required; a vendor that cannot be reached 503 licence_unverifiable. The token is returned once and lives 30 days. Budget 30/hour per IP.
Тело захтева
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
product | string<page-builder-sandwich> | Да | — |
install_id | string | Да | — |
license_id | string | Да | — |
site_url | string | Да | — |
timestamp | integer | Да | Unix seconds; within 300 s of the server clock. |
nonce | string | Да | — |
signature | string | Да | — |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
token | string | Да | zpl_…, shown once. |
expires_at | string | Да | — |
account | PbsLibraryAccount | Да | — |
Грешке које ова крајња тачка може вратити
401 · 403 · 422 · 429 · 503