canonical: https://jentic.com/apis/swaggerhub.gmf-tech/api-auctions

# Gmf Tech API Auctions

Swagger da API responsável pela construção e operações da tela de lances. The API exposes 2 endpoints secured with oauth2 authentication.

## For AI agents

Programmatically procurar por pregoes de hoje, procurar por pregoes de hoje. Covers 2 operations with oauth2 authentication.

## Scope

Does not handle payments, communications, or crm - use for developer tools only.

## Capabilities

- Procurar por pregoes de hoje
- Manage developer tools data programmatically
- Integrate API Auctions into automated workflows
- Query and filter API Auctions records by parameters
- Monitor API Auctions operational status and events

## Use cases

### Developer Tools Operations

Use the API Auctions to perform developer tools operations programmatically. The API provides 2 endpoints covering core functionality including procurar por pregoes de hoje, procurar por pregoes de hoje.

Example prompt: Call GET /bids/{proposal_id} to procurar por pregoes de hoje

### Data Retrieval and Monitoring

Query API Auctions resources on a schedule to track changes, generate alerts, or feed downstream dashboards. Agents poll relevant endpoints, compare against previous state, and trigger actions when thresholds are crossed.

Example prompt: Poll the primary API Auctions endpoint, compare response to last known state, and alert if changed

### AI Agent Integration via Jentic

AI agents discover and call API Auctions endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle oauth2 tokens manually.

Example prompt: Search Jentic for 'procurar por pregoes de hoje', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /bids/{proposal_id} | Procurar por pregoes de hoje |
| GET | /bids/today | Procurar por pregoes de hoje |

## Key resources

- **bids** — tela de lances (local, web, ERPs)

## Why Jentic

- **Setup:** Wiring the Bidbr API Auctions service by hand means running its OAuth2 password flow against api-login.bidbr.com.br, mapping the right ACL scopes, and refreshing tokens and retrying yourself. Through Jentic you install once, import API Auctions from the API Directory, store the credentials once, and your agent calls it.
- **Permission scoping:** This API puts the proposal id in the URL path (/bids/{proposal_id}), so a rule can pin your agent to one proposal's bids: it can read that proposal and today's bids and nothing else. You choose the operations it may call, so it stays read-only unless you add more.
- **Credential handling:** Your API Auctions OAuth2 credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'read bids for a proposal' or 'list today's bids', and Jentic returns the matching API Auctions operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Github** — Alternative developer tools API
- **Gitlab** — Alternative developer tools API

## FAQ

### What authentication does the API Auctions use?

The API Auctions uses OAuth 2.0 for authorization. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I procurar por pregoes de hoje with the API Auctions?

Yes. Use the GET /bids/{proposal_id} endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the API Auctions?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I procurar por pregoes de hoje through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'procurar por pregoes de hoje'. Jentic returns the matching API Auctions operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the API Auctions have?

The API Auctions exposes 2 endpoints covering bids operations.

### Can I limit what my agent is allowed to do with the API Auctions?

Yes. Jentic One is self-hosted, so your own rules decide which operations and credentials the agent may use. Because the proposal id lives in the URL path, you can pin the agent to a single proposal and let it call only GET /bids/{proposal_id} and GET /bids/today, keeping it read-only. It cannot reach any other proposal or operation unless you grant it.