Getting started
Step-by-step to generate an OAuth token and make your first authenticated call to the Yep Platform REST API.
OAuth 2.0
Bearer Token
5 minutes
Prerequisites
What you need before starting:
- Integration registered in the admin panel with
client_idandclient_secret. - Access to the OAuth endpoint (
/api2/oauth/token). - HTTP client capable of sending JSON and the
Authorization: Bearer <token>header.
Minimum flow to start
Three calls cover the full cycle: obtain token, validate API and send the first authenticated request.
1. Get token via client credentials
POST/api2/oauth/token
Access token issuance via client_credentials. Send as application/x-www-form-urlencoded.
client_id=YOUR_CLIENT_ID
client_secret=YOUR_CLIENT_SECRET
grant_type=client_credentials
2. Validate availability
GET/api2/oauth/health
Public API healthcheck. No authentication required.
{
"status": "ok",
"message": "API Rest da Plataforma Yep! Ativa"
}
3. First authenticated call
Send the required headers
After getting the token, include Authorization: Bearer <token> and Content-Type: application/json on all protected endpoints.