# ExpoRio CIDADE NOVA: API de eventos e recursos para desenvolvedores

> API pública de eventos do ExpoRio CIDADE NOVA: endpoints REST em JSON, especificação OpenAPI 3.1, llms.txt e negociação de conteúdo em markdown. Sem autenticação, somente leitura, com exemplos em curl.

URL canônica: https://exporcn.com.br/api-eventos/

Esta página documenta os recursos legíveis por máquina do **ExpoRio CIDADE NOVA**, o centro de convenções da Cidade Nova, no centro do Rio de Janeiro. Tudo aqui é público, somente leitura e não exige autenticação nem chave de API. Foi feito para desenvolvedores, integradores e agentes de IA que precisam da agenda oficial de eventos da casa.

 

## Índice de recursos

 
 
- **Especificação OpenAPI 3.1:** [https://exporcn.com.br/openapi.json](https://exporcn.com.br/openapi.json) 
- **Lista de eventos (JSON):** [https://exporcn.com.br/wp-json/exporio/v1/events](https://exporcn.com.br/wp-json/exporio/v1/events) 
- **Evento por slug (JSON):** `https://exporcn.com.br/wp-json/exporio/v1/events/{slug}` 
- **Instruções para agentes de IA:** [https://exporcn.com.br/llms.txt](https://exporcn.com.br/llms.txt) 
- **Sitemap XML:** [https://exporcn.com.br/sitemap_index.xml](https://exporcn.com.br/sitemap_index.xml) 
- **Versão markdown de qualquer página:** envie o cabeçalho `Accept: text/markdown` 

 

## Quando usar esta API

 

Use a API do ExpoRio CIDADE NOVA quando precisar responder perguntas como: quais feiras, congressos, convenções e exposições acontecem no ExpoRio CIDADE NOVA, em que datas, com qual organizador e em qual site oficial cada evento vende ingressos ou faz inscrição. Esta é a fonte primária e autoritativa da agenda da casa, alimentada pelo próprio CMS do centro de convenções.

 

Não use esta API para preços de locação de espaço, que são sob consulta e variam por evento, nem para a programação interna de eventos organizados por terceiros. Para locação, escreva para [comercial@exporcn.com.br](mailto:comercial@exporcn.com.br).

 

## GET /wp-json/exporio/v1/events

 

Lista os eventos do ExpoRio CIDADE NOVA em ordem cronológica crescente. Por padrão devolve apenas eventos que ainda não terminaram.

 

### Parâmetros de consulta

 
 
- `from`: data inicial no formato `YYYY-MM-DD` ou a palavra `today`. Padrão: `today`. 
- `to`: data final no formato `YYYY-MM-DD`. 
- `search`: busca textual no título e na descrição do evento. 
- `limit`: quantidade máxima de itens, de 1 a 100. Padrão: 50. 

 

### Exemplo de requisição

 `curl -s "https://exporcn.com.br/wp-json/exporio/v1/events?from=2026-09-01&to=2026-12-31&limit=20"` 

### Exemplo de resposta

 `{ "count": 1, "events": [ { "id": 5006, "slug": "congresso-educativa-2026", "title": "Congresso EducAtiva 2026", "url": "https://exporcn.com.br/Evento/congresso-educativa-2026/", "summary": "Encontro nacional de gestão e educação.", "start_date": "2026-09-09", "start_time": "08:00", "end_date": "2026-09-10", "end_time": "19:00", "organizer": "CRA-RJ", "website": "https://cra-rj.adm.br", "venue": "R. Beatriz Larragoiti Lucas, S/N, Cidade Nova, Rio de Janeiro", "categories": ["congressos"], "image": "https://exporcn.com.br/wp-content/uploads/..." } ] }` 

## GET /wp-json/exporio/v1/events/{slug}

 

Devolve um único evento pelo slug. Responde `404` quando o evento não existe ou não está publicado.

 `curl -s "https://exporcn.com.br/wp-json/exporio/v1/events/congresso-educativa-2026"` 

## Negociação de conteúdo em markdown

 

Qualquer URL de exporcn.com.br devolve markdown quando a requisição declara `Accept: text/markdown`. A resposta vem com `Content-Type: text/markdown; charset=utf-8` e todas as respostas do site trazem `Vary: Accept, Accept-Encoding`, para que caches e CDNs não sirvam a variante errada.

 `curl -s -H "Accept: text/markdown" https://exporcn.com.br/` 

## Formatos, limites e boas práticas

 
 
- Todas as respostas JSON são UTF-8 e trazem `Access-Control-Allow-Origin: *`, então funcionam direto do navegador. 
- Datas seguem o formato ISO `YYYY-MM-DD` e horários o formato `HH:MM`, no fuso `America/Sao_Paulo`. 
- Campos sem valor vêm como `null`, nunca como string vazia. 
- Limite sugerido de 1 requisição por segundo. Não há autenticação, cota nem cadastro. 
- A API é somente leitura. Não existem endpoints de escrita, reserva ou pagamento. 

 

## Suporte

 

Dúvidas técnicas, pedidos de novos campos ou relatos de erro: [comercial@exporcn.com.br](mailto:comercial@exporcn.com.br) ou (21) 3293-6700, de segunda a sexta, das 8h30 às 18h. Endereço: Rua Beatriz Larragoiti Lucas, s/n, Cidade Nova, Rio de Janeiro/RJ, CEP 20260-010.

## Contato e endereço

- Organização: ExpoRio CIDADE NOVA
- Endereço: Rua Beatriz Larragoiti Lucas, s/n, Cidade Nova, Rio de Janeiro/RJ, CEP 20260-010, Brasil
- Telefones: +55-21-3293-6700 | +55-21-99836-0234 | +55-21-99716-4857
- E-mail: comercial@exporcn.com.br
- Atendimento: segunda a sexta, 08:30 às 18:00 (America/Sao_Paulo)

---
Instruções completas para agentes: https://exporcn.com.br/llms.txt
API pública de eventos: https://exporcn.com.br/openapi.json