Авторизация
Токен передаётся в заголовке API-Token.
curl -s "$API/me" -H "API-Token: $TOKEN"- Формат токена:
pl_live_<app_id>_<40 символов>у боевого приложения иpl_test_<app_id>_<40 символов>у sandbox (testnet). По префиксу видно, что тестовый ключ попал в боевой код. Токены старого формата<app_id>:AA...продолжают работать. Токен показывается один раз при создании в кабинете (раздел «Токены» приложения). Сервер хранит только SHA-256 токена. - Токен принадлежит одному приложению и видит только его инвойсы, баланс и выводы.
- Отозванный токен сразу перестаёт работать (
401 UNAUTHORIZED). То же для всех токенов аккаунта, заблокированного оператором.
Scopes. Новый токен по умолчанию получает invoices:write, invoices:read и balance:read. Scope withdrawals:write добавляется только при включённой 2FA и с кодом из приложения-аутентификатора, чтобы утёкший с сайта токен не позволял вывести деньги.
| Scope | Что даёт |
|---|---|
invoices:write | POST /invoices, DELETE /invoices/{id} |
invoices:read | GET /invoices, GET /invoices/{id} |
balance:read | GET /balance, GET /withdrawals/{id}, GET /stats |
withdrawals:write | POST /withdrawals |
| без scope | GET /me, GET /currencies, POST /webhooks/test |