# Sekron Digital Developer Portal

This is a public, read-only developer portal for AI agents, crawlers and integration auditors. It documents the machine-readable resources available for Sekron Digital without changing the visible website navigation.

## API keys

No API key is required for the public read-only discovery endpoints listed below. These endpoints do not create leads, do not change customer data and do not expose private operational systems. Commercial forms, support requests and restricted systems still require the official website flows and authorized access.

## Quickstart

Use the canonical OpenAPI file first, then call the read-only endpoints needed for entity resolution or service discovery.

```bash
curl -fsSL https://www.sekrondigital.com.br/openapi.json
curl -fsSL https://www.sekrondigital.com.br/wp-json/sekron/v1/company
curl -fsSL https://www.sekrondigital.com.br/wp-json/sekron/v1/services
curl -fsSL -H 'Accept: text/markdown' https://www.sekrondigital.com.br/
```

## Sandbox environment

The public sandbox is the same read-only discovery surface used by agents: `/openapi.json`, `/api/openapi.yaml`, `/llms.txt`, `/agent-instructions.txt`, `/index.md`, `/agents.md`, `/mcp.json` and the `/wp-json/sekron/v1/*` endpoints. There are no write operations in this public sandbox.

## Endpoints

- `GET https://www.sekrondigital.com.br/wp-json/sekron/v1/company` — company profile, contact points, address, audiences and services.
- `GET https://www.sekrondigital.com.br/wp-json/sekron/v1/services` — public service list.
- `GET https://www.sekrondigital.com.br/wp-json/sekron/v1/pages` — canonical public pages.
- `GET https://www.sekrondigital.com.br/wp-json/sekron/v1/health` — agent resource health and discovery URLs.
- `GET https://www.sekrondigital.com.br/openapi.json` — OpenAPI JSON.
- `GET https://www.sekrondigital.com.br/api/openapi.yaml` — OpenAPI YAML.

## Rate limits and errors

Public API responses include `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset`. If a request receives `429`, wait for `Retry-After`. JSON errors follow the documented `ErrorResponse` schema with `code`, `message`, `hint`, `status`, `docs` and `request_id`.

## Versioning and deprecation policy

The public discovery API is versioned in the URL as `/wp-json/sekron/v1/*`. Non-breaking additions may appear inside version 1. Breaking changes will use a new URL version, for example `/wp-json/sekron/v2/*`. Active endpoints send `API-Version: 1` and `Deprecation: false`. Deprecated endpoints will be announced in this portal and in the OpenAPI description before removal. When a removal date is known, responses will include a `Sunset` header and a `Link` header pointing to the migration guidance.

## CLI and SDK status

Sekron Digital does not publish an official npm, PyPI or Homebrew CLI for this read-only public discovery surface at this time. Agents should use the OpenAPI schema, MCP endpoint or direct HTTPS endpoints documented here.

## When to use this developer portal

Use this portal when an agent needs to identify Sekron Digital, cite canonical URLs, understand public services, find the OpenAPI schema, fetch Markdown content, or route a user toward the official commercial/support channels. Do not use it for emergency dispatch, private account access, customer data, live monitoring operations or legal/security decisions.

## Contact

Commercial contact: comercial@sekrondigital.com.br

Phone: +55 11 3528-3666
