SparkGlim Programadores
Dar ao assistente o contexto certo.

Prepare uma instrução com documentação verificada. Escolha produto, tecnologia e assistente; copie ou transfira o guião público.
Escolha o produto API
Escolha a sua tecnologia
Escolha o seu assistente
Campanhas públicas e participação

Mostrar campanhas públicas elegíveis e ligar a participação suportada.
Requisitos prévios: Use apenas registos públicos e regras exatas de cada operação.
Âmbito verificado e limites: Dados públicos não incluem compradores, doadores, contas privadas nem campanhas por publicar.
# SparkGlim — Campanhas públicas e participação

Ajude-me a implementar uma integração SparkGlim apenas com as fontes públicas verificadas abaixo. Mantenha o produto API escolhido separado dos outros modelos.

Escolha a sua tecnologia: TypeScript
Escolha o seu assistente: Codex
Língua da documentação: pt

## Experiência prevista

Mostrar campanhas públicas elegíveis e ligar a participação suportada.

## Requisitos prévios

Use apenas registos públicos e regras exatas de cada operação.

## Arquitetura e limites de confiança

Use a linguagem escolhida para HTTP no servidor e mantenha aí a autenticação privada. Não invente SDK oficial nem comando de instalação.

Use o assistente como apoio ao desenvolvimento. Explique alterações propostas e dê prioridade às fontes públicas sobre sugestões geradas.

## Autenticação e permissões

O acesso depende da conta, domínios, âmbitos, membros e visibilidade. Escolher país ou língua não ativa pagamentos nem muda a moeda.

## Operações verificadas para este guião

Apenas operações implementadas e verificadas aparecem abaixo. As não verificadas ou retiradas são excluídas; não substitua capacidades em falta por rotas privadas.

Os campos, tipos e validações são requisitos do protocolo, não registos de clientes.

### GET /api/public/payment-methods/:campaignId — Opções de pagamento da campanha

Lista métodos ativos para país de venda, moeda e cliente de campanha aprovada sem segredos.

Modelo de acesso: API pública

Contrato do pedido:
- campaignId (path; string; Obrigatório): Campanha existente na conta e no âmbito mais limitado de qualquer credencial de campanha. Validação: UUID ou identificador de recurso documentado.
- app_type (query; enum; Opcional): Contexto existente para escolher configuração Web ou App; sem permissões extra. Validação: user_app se selecionado pelo utilizador; caso contrário web.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":{"methods":["item"],"currency":"string","country":"string"}}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
Abra o URL de pagamento devolvido. O SparkGlim Server controla preços, métodos, verificação e entrega; o regresso do navegador apenas navega.

https://developer.sparkglim.net/reference/public/public-get-api-public-payment-methods-campaignId?lang=pt

### GET /api/public/tickets/public-verify — Verificação pública de bilhetes

Encaminha verificação da credencial ao leitor Web e mantém estado e resultado; não regista admissão.

Modelo de acesso: API pública

Contrato do pedido:
- code (query; string; Obrigatório): Credencial ou código exigido; nunca publique OTP real ou segredo de bilhete. Validação: Credencial de bilhete válida.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":{"ticket_code":"string","checked_in":"boolean","checked_in_at":"null","details_revealed":"boolean","campaign":{"title":"string","slug":"string","venue":"string"},"ticket_name":"string"}}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
Abra o URL de pagamento devolvido. O SparkGlim Server controla preços, métodos, verificação e entrega; o regresso do navegador apenas navega.
Trate códigos como credenciais. Pode mostrar dados após entrada; verificar não a autoriza.

https://developer.sparkglim.net/reference/public/public-get-api-public-tickets-public-verify?lang=pt

### GET /api/public/blog — Artigos publicados

Lista artigos publicados com pesquisa, categoria, destaques e paginação exata.

Modelo de acesso: API pública

Contrato do pedido:
- category (query; string; Opcional): Categoria de campanha ou definições aprovadas conforme recurso. Validação: Identificador de categoria no URL.
- search (query; string; Opcional): Filtro textual aplicado aos registos publicados selecionados. Validação: Texto de pesquisa.
- featured (query; string; Opcional): Ativa filtro de artigos destacados com valor true. Validação: true.
- limit (query; number; Opcional): Máximo de registos na página; aplica-se o limite fixo do endpoint. Validação: 1–30; valor predefinido: 10.
- offset (query; number; Opcional): Número de artigos publicados a ignorar antes da página, a partir de zero. Validação: >=0; valor predefinido: 0.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":["item"],"count":"number","limit":"number","offset":"number"}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
Abra o URL de pagamento devolvido. O SparkGlim Server controla preços, métodos, verificação e entrega; o regresso do navegador apenas navega.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog?lang=pt

### GET /api/public/blog/categories — Categorias de artigos

Lista categorias ativas por posição configurada e número de artigos.

Modelo de acesso: API pública

Contrato do pedido:
Sem campos documentados.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":["item"]}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
Abra o URL de pagamento devolvido. O SparkGlim Server controla preços, métodos, verificação e entrega; o regresso do navegador apenas navega.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-categories?lang=pt

### GET /api/public/blog/:slug — Detalhe de artigo publicado

Devolve artigo publicado e até quatro relacionados, e incrementa visualizações.

Modelo de acesso: API pública

Contrato do pedido:
- slug (path; string; Obrigatório): Identificador de URL da campanha ou artigo publicado existente. Validação: Identificador URL público.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":{"post":{"id":"string","slug":"string","title":"string","status":"string"},"relatedPosts":["item"]}}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
Abra o URL de pagamento devolvido. O SparkGlim Server controla preços, métodos, verificação e entrega; o regresso do navegador apenas navega.
Ler um artigo incrementa as visualizações. Este GET não é uma inspeção sem alterações.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-slug?lang=pt

### GET /api/public/homepage/discovery — Descoberta de campanhas públicas

Pesquisa índice público estrito por produto, país, período, local e data; devolve paginação exata e dados permitidos.

Modelo de acesso: API pública

Contrato do pedido:
- q (query; string; Opcional): Texto pesquisado em título, descrição, organizador, local ou beneficiário públicos. Validação: <=100.
- country (query; string; Opcional): Filtro pelo país configurado da campanha; não ativa pagamentos nem converte moeda. Validação: ISO2.
- location (query; string; Opcional): Local público ou filtro; separado do país financeiro de venda. Validação: <=100.
- type (query; enum; Opcional): Tipo de recurso, reação ou filtro de campanha suportado aqui. Validação: all | ticketing | voting | donation.
- status (query; enum; Opcional): Estado suportado pedido; aprovação controla publicação e acesso. Validação: all | active | upcoming | ended | postponed.
- sort (query; enum; Opcional): Seleciona ordem do servidor: destaques, recentes ou fecho. Validação: featured | latest | ending.
- date (query; enum; Opcional): Limita pesquisa à janela de data documentada do filtro existente. Validação: all | today | tomorrow | weekend | month.
- page (query; integer; Opcional): Página pedida conforme numeração documentada; preserve metadados do servidor. Validação: 1–1000000.
- limit (query; integer; Opcional): Máximo de registos na página; aplica-se o limite fixo do endpoint. Validação: 1–24; valor predefinido: 12.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":{"entries":["item"],"countries":["item"],"locations":["item"],"pagination":{"page":"number","limit":"number","total":"number","pages":"number","hasMore":"boolean"},"available":"boolean"}}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
Devolva apenas registos permitidos por conta, campanha e visibilidade.

https://developer.sparkglim.net/reference/public/public-get-api-public-homepage-discovery?lang=pt

### GET /api/public/homepage/campaigns — Campanhas da página inicial

Devolve até72 campanhas públicas ativas de país opcional; não é índice completo paginado.

Modelo de acesso: API pública

Contrato do pedido:
- country (query; string; Opcional): Filtro pelo país configurado da campanha; não ativa pagamentos nem converte moeda. Validação: ISO2.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":{"campaigns":["item"],"countries":["item"],"available":"boolean"}}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
Campanhas públicas ativas, máximo72, sem paginação.

https://developer.sparkglim.net/reference/public/public-get-api-public-homepage-campaigns?lang=pt

### GET /api/public/homepage/awards — Campanhas públicas de prémios

Devolve até200 campanhas públicas aprovadas, terminadas ou adiadas, por destaque e criação.

Modelo de acesso: API pública

Contrato do pedido:
- country (query; string; Opcional): Filtro pelo país configurado da campanha; não ativa pagamentos nem converte moeda. Validação: ISO2.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":{"campaigns":["item"],"countries":["item"],"available":"boolean"}}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
Só votação, máximo200, sem paginação.

https://developer.sparkglim.net/reference/public/public-get-api-public-homepage-awards?lang=pt

### GET /api/public/countries — Catálogo de países ativos

Devolve catálogo ativo de países e moedas padrão; não lista corredores de pagamento ativos.

Modelo de acesso: API pública

Contrato do pedido:
Sem campos documentados.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":[{"code":"string","name":"string","phoneCode":"string","isDefault":"boolean","currency":"object"}]}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
O catálogo não ativa pagamentos nem domínios nacionais.

https://developer.sparkglim.net/reference/public/public-get-api-public-countries?lang=pt

### GET /api/public/blog/:slug/reactions — Ler reações

Conta reações do artigo publicado e escolhas atuais sem devolver identidades alheias.

Modelo de acesso: API pública

Contrato do pedido:
- slug (path; string; Obrigatório): Identificador de URL da campanha ou artigo publicado existente. Validação: Identificador URL público.
- visitorId (query; string; Opcional): Identidade do visitante usada para consultar ou alternar a sua reação. Validação: Identidade do visitante.
- profileToken (query; string; Opcional): Token de perfil comunitário verificado existente; este endpoint não cria identidade. Validação: Perfil de comunidade existente e verificado.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":{"counts":{"like":"number","love":"number","insightful":"number","celebrate":"number","clap":"number"},"mine":["item"]}}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-slug-reactions?lang=pt

### GET /api/public/blog/:slug/comments — Comentários aprovados

Lista até500 comentários aprovados de antigos a novos sem contacto privado do autor.

Modelo de acesso: API pública

Contrato do pedido:
- slug (path; string; Obrigatório): Identificador de URL da campanha ou artigo publicado existente. Validação: Identificador URL público.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":["item"]}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
Até500 comentários aprovados, antigos primeiro, sem paginação.

https://developer.sparkglim.net/reference/public/public-get-api-public-blog-slug-comments?lang=pt

### GET /api/public/qr/ticket/:code — Imagem QR do bilhete

Devolve PNG de marca de tamanho limitado para credencial; gerar não concede propriedade.

Modelo de acesso: API pública

Contrato do pedido:
- code (path; string; Obrigatório): Credencial ou código exigido; nunca publique OTP real ou segredo de bilhete. Validação: UUID ou identificador de recurso documentado.
- size (query; integer; Opcional): Largura de imagem QR limitada pelo motor existente. Validação: 128–1024; valor predefinido: 512.

Estado HTTP de sucesso: 200

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Disponibilidade verificada no código, sem garantia de produção.
Resposta PNG binária, não JSON. Mostrar um código não autoriza entrada.

https://developer.sparkglim.net/reference/public/public-get-api-public-qr-ticket-code?lang=pt

### GET /api/participants/search — Pesquisa pública por código

Procura nomeado aprovado ou campanha pública por código ou slug conforme visibilidade e categoria ativa.

Modelo de acesso: API pública

Contrato do pedido:
- code (query; string; Obrigatório): Credencial ou código exigido; nunca publique OTP real ou segredo de bilhete. Validação: Código de nomeado, participante ou campanha, ou identificador URL de campanha; q aceite como alias.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","resultType":"string","participant":{"id":"string","name":"string","bio":"null","category":"null","vote_count":"null","show_vote_count":"boolean","participant_code":"string","nominee_code":"null","image_url":"null"},"campaign":{"id":"string","title":"string","slug":"string","status":"string","campaign_type":"string","vote_price":"number","image_url":"null","banner_url":"null"}}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Este controlador Web não define limitador próprio; podem existir controlos anteriores.

Disponibilidade verificada no código, sem garantia de produção.
Devolva apenas registos permitidos por conta, campanha e visibilidade.

https://developer.sparkglim.net/reference/public/public-get-api-participants-search?lang=pt

### GET /api/public/voting-counts/:campaignId — Totais públicos conforme visibilidade

Devolve votos concluídos só para campanha pública, nomeados aprovados e categorias ativas com totais públicos explícitos.

Modelo de acesso: API pública

Contrato do pedido:
- campaignId (path; string; Obrigatório): Campanha existente na conta e no âmbito mais limitado de qualquer credencial de campanha. Validação: UUID ou identificador de recurso documentado.

Estado HTTP de sucesso: 200
Contrato de resposta esperado: {"success":"boolean","data":{"visible":"boolean","voteCounts":{}}}

Validação e recuperação: Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Este controlador Web não define limitador próprio; podem existir controlos anteriores.

Disponibilidade verificada no código, sem garantia de produção.
Devolva apenas registos permitidos por conta, campanha e visibilidade.

https://developer.sparkglim.net/reference/public/public-get-api-public-voting-counts-campaignId?lang=pt

## Gestão de credenciais e pedidos

Nunca inclua chaves reais, sessões, URL privados, contactos, OTP ou campanhas por publicar. Use valores de exemplo e peça contexto sem segredos.

## Validação e recuperação

Valide segundo o esquema. Preserve referências e chaves de idempotência, use nonces novos e não repita erros de validação ou permissões sem alterações.

## Encaminhamento para pagamento central

Para participação paga, crie a sessão suportada no servidor e abra o URL checkout.sparkglim.net devolvido. O SparkGlim Server controla prestador, verificação e entrega. Não adicione verificação nem consultas periódicas de pagamento no navegador.

## Âmbito verificado e limites

Dados públicos não incluem compradores, doadores, contas privadas nem campanhas por publicar.

A implementação no código não demonstra disponibilidade em produção. Consulte o estado atual da API e a origem documentada antes de usar uma operação. Se a API necessária estiver indisponível, pare e peça o próximo passo aprovado; não invente alternativas nem chame uma API privada do painel.

## Fontes públicas oficiais

- https://developer.sparkglim.net/public-api?lang=pt
- https://developer.sparkglim.net/responses?lang=pt
- https://developer.sparkglim.net/security?lang=pt
- https://developer.sparkglim.net/api-status?lang=pt

## Instruções a manter no repositório

Leia as instruções do projeto. Reutilize componentes e transportes, preserve trabalho alheio e proponha testes específicos. Não execute pagamentos, alterações de conta ou mensagens reais sem autorização.

Explique a arquitetura, liste as operações documentadas exatas e proponha um plano mínimo de servidor e cliente. Identifique capacidades indisponíveis e peça contexto sem solicitar segredos.
Copie este guião para o assistente ou adicione o ficheiro ao projeto. Escolher um assistente não liga contas nem envia a instrução.
Use apenas documentação pública e valores de exemplo. Não inclua credenciais, dados de clientes ou campanhas privadas nas instruções.
Campanhas públicas e participação

Continuar a desenvolver
