Nomes alternativos do login
Os endereços wk_pos_login e wkposlogin, que fazem exatamente o mesmo que pos_login, para os terminais instalados.
Os terminais antigos chamam o login por wk_pos_login (nome da Venddor 1.0) ou wkposlogin (nome do app, sem sublinhado). Todos os endereços desta página executam o mesmo código de Login do caixa: mesmos campos, mesma resposta, mesmos erros. Eles continuam no ar para que nenhum terminal instalado precise ser atualizado. Em software novo use pos_login.
As credenciais do terminal (Authorization) também são obrigatórias aqui. A forma com /api/v1.0 devolve ids em UUID; a forma /api devolve ids decimais.
/api/v1.0/wk_pos_loginAutenticadaMesmo que pos_login (POST), ids UUID
Igual a POST /api/v1.0/pos_login. Credenciais no corpo JSON ou formulário.
Corpo da requisição
user_loginstringobrigatóriopasswordstringobrigatório/api/v1.0/wk_pos_loginAutenticadaMesmo que pos_login (GET), ids UUID
Igual a GET /api/v1.0/pos_login. Credenciais na query string; evite em produção, a senha fica na URL.
Parâmetros de consulta
user_loginstringobrigatóriopasswordstringobrigatório/api/wk_pos_loginAutenticadaMesmo que pos_login (POST), ids decimais
Igual a POST /api/pos_login. Credenciais no corpo JSON ou formulário.
Corpo da requisição
user_loginstringobrigatóriopasswordstringobrigatório/api/wk_pos_loginAutenticadaMesmo que pos_login (GET), ids decimais
Igual a GET /api/pos_login. Credenciais na query string; evite em produção, a senha fica na URL.
Parâmetros de consulta
user_loginstringobrigatóriopasswordstringobrigatório/api/v1.0/wkposloginAutenticadaMesmo que pos_login (POST), ids UUID
Igual a POST /api/v1.0/pos_login. Credenciais no corpo JSON ou formulário.
Corpo da requisição
user_loginstringobrigatóriopasswordstringobrigatório/api/v1.0/wkposloginAutenticadaMesmo que pos_login (GET), ids UUID
Igual a GET /api/v1.0/pos_login. Credenciais na query string; evite em produção, a senha fica na URL.
Parâmetros de consulta
user_loginstringobrigatóriopasswordstringobrigatório/api/wkposloginAutenticadaMesmo que pos_login (POST), ids decimais
Igual a POST /api/pos_login. Credenciais no corpo JSON ou formulário.
Corpo da requisição
user_loginstringobrigatóriopasswordstringobrigatório/api/wkposloginAutenticadaMesmo que pos_login (GET), ids decimais
Igual a GET /api/pos_login. Credenciais na query string; evite em produção, a senha fica na URL.
Parâmetros de consulta
user_loginstringobrigatóriopasswordstringobrigatórioExemplo de requisição
curl -X POST "$BASE_URL/api/v1.0/wk_pos_login" \
-u "$TERMINAL_EMAIL:$TERMINAL_API_KEY" \
-d "user_login=caixa@minhaloja.com.br" -d "password=senha-do-caixa"Resposta
{
"status": 200,
"data": { "success": true, "message": "", "access_token": "eyJhbGciOiJIUzI1NiIs...", "agent_info": { "user_id": "d4613dde-ac7a-431c-9232-50d8cd6ad5fc" } }
}A resposta completa, com todos os campos, está em Login do caixa.
Erros
Os mesmos de Login do caixa: data.success: false com Required params missing: user_login, password, Incorrect login or password, User not found ou Account is not active (sempre HTTP 200), e 401 quando falta a credencial do terminal.