Autenticação
Este guia cobre como autenticar requisições à REST API do SportsPress usando Senhas de Aplicativo e Postman.
Requisições GET (leitura de dados) não requerem autenticação. A autenticação é necessária para operações POST, PUT, PATCH e DELETE.
Pré-requisitos:
Uma instalação do WordPress com o SportsPress ativo
Conta de usuário Administrador ou Editor
Passo 1 — Baixar e Instalar o Postman
Acesse https://www.postman.com/downloads/ e baixe o aplicativo desktop. A criação de conta é opcional. Após a instalação, abra o aplicativo e crie uma conta ou selecione "Skip and go to the app." Crie uma nova requisição clicando na aba [+].
Passo 2 — Gerar uma Senha de Aplicativo
As Senhas de Aplicativo estão integradas ao WordPress 5.6 e posterior. Para versões mais antigas, instale o plugin Application Passwords em https://wordpress.org/plugins/application-passwords/.
Vá para Usuários no admin do WordPress.
Clique no seu nome de usuário para abrir o perfil de usuário.
Role até a seção Senhas de Aplicativo.
Digite um nome para a senha (ex.: "Postman" ou "API Client").
Clique em Adicionar Nova Senha de Aplicativo.
Um modal exibe a senha gerada — copie-a imediatamente e armazene-a com segurança. Ela não será exibida novamente.
Passo 3 — Configurar Autenticação Básica no Postman
Abra sua requisição no Postman.
Clique na aba Authorization.
Defina o Type como Basic Auth.
Digite seu Nome de Usuário do WordPress no campo Username.
Cole a Senha de Aplicativo gerada no Passo 2 no campo Password.
Passo 4 — Definir o Cabeçalho Content-Type
Para requisições POST, PUT e PATCH que enviam um corpo JSON, adicione o seguinte cabeçalho:
Chave | Valor |
|
|
Navegue até a aba Headers no Postman e adicione este par chave-valor.
Passo 5 — Enviar uma Requisição de Teste
Teste a autenticação com uma requisição GET que não requer autenticação para confirmar a conectividade:
GET https://example.com/wp-json/sportspress/v2/teams
Em seguida, teste uma operação de escrita. Por exemplo, atualizar um time:
PUT https://example.com/wp-json/sportspress/v2/teams/123
Com um corpo JSON:
{
"title": "Updated Team Name"
}Uma resposta 200 OK com o objeto atualizado confirma que a autenticação está funcionando.
Autenticação em Código
Para integrações no lado do servidor, passe as credenciais via cabeçalho Authorization usando username:application_password codificado em Base64:
$response = wp_remote_post(
'https://example.com/wp-json/sportspress/v2/events',
array(
'headers' => array(
'Authorization' => 'Basic ' . base64_encode( 'username:application-password' ),
'Content-Type' => 'application/json',
),
'body' => json_encode( array(
'title' => 'New Event',
'status' => 'publish',
) ),
)
);Para clientes JavaScript rodando em um navegador, use autenticação baseada em cookie com um nonce — consulte o guia de Autenticação da WP REST API v2 para detalhes.