Introdução

Autenticação

A API utiliza API Keys no formato vp_... Após registrar um usuário, uma API Key é gerada automaticamente. Guarde-a em local seguro — ela não pode ser recuperada.

Nunca exponha sua API Key no client-side (browser). Use sempre no servidor. O endpoint POST /payment/send aceita somente API Key (não JWT).

Header de autenticação

Envie a API Key via header em qualquer requisição autenticada:

<span style="color:#86efac">X-API-Key:</span> vp_sua_api_key_aqui
<span style="color:#86efac">Content-Type:</span> application/json

Exemplo com cURL

bash

# Usando X-API-Key
curl -X GET https://api.piv.lol/api/v1/user/get \
  -H "X-API-Key: vp_sua_api_key" \
  -H "Content-Type: application/json"

Onde obter a API Key

Sua API Key é gerada no momento do registro da conta via POST /user/register. Ela aparece apenas uma vez na resposta. Se perdida, não é possível recuperá-la — será necessário criar uma nova conta.

Formato da API Key

vp_xxxxxxxxxxxxxxxxxxx

Prefixo vp_ seguido de 19+ caracteres alfanuméricos.