AttendBeacon
Abrir a área de trabalho

Mais

Registo de alterações e versões

O que mudou na API e quando, e como a AttendBeacon a altera sem estragar o que construiu.

Versões

A versão está no endereço: /api/v1. Um fluxo ou uma integração criados sobre a v1 não têm de ser refeitos quando a AttendBeacon muda, por isso, dentro da v1:

  • Acrescenta-se, nunca se retira. Novas operações, novos campos nas respostas, novos parâmetros opcionais, novos valores numa lista, como um tipo de webhook ou um código de erro. Escreva código que ignore o que não conhece.
  • Nunca se renomeia nem remove: um campo, uma operação, um âmbito, um código de erro ou um tipo de webhook, depois de publicado.
  • Uma alteração que quebra compatibilidade é a v2. É anunciada aqui e por e-mail a todas as áreas de trabalho com uma chave pelo menos seis meses antes de a v1 mudar, e a v1 continua a funcionar durante esses seis meses.
  • O que fica obsoleto é marcado como deprecated na descrição OpenAPI e listado aqui, com a data em que desaparece.

Não são alterações neste sentido: a ordem dos campos num corpo, o texto de detail (decida com base em code), novos cabeçalhos de resposta e a correção de uma resposta que contradizia esta documentação.

A descrição OpenAPI 3.1 em /api/v1/openapi.json é a API tal como está agora; info.version muda a cada acréscimo.

2026-10-15: v1.1, a plataforma para programadores

  • Âmbitos por área. Os âmbitos de uma chave são agora uma área e um acesso (events:read, attendees:write), e os dados pessoais têm o seu próprio âmbito, people:read. As chaves criadas antes mantêm exatamente o que podiam fazer.
  • As chaves expiram e ficam registadas. Uma chave pode expirar após 30, 90, 180 ou 365 dias. Cada chamada fica em Atividade das chaves, incluindo as recusas.
  • Problem details. As recusas são application/problem+json RFC 9457 com um code estável; error mantém-se ao lado de detail para os fluxos criados antes.
  • Cursores e sincronização. Todas as listas respondem com nextCursor e hasMore; as listas de coisas que mudam aceitam updatedSince. page e pageSize continuam a funcionar onde funcionavam.
  • Novas tentativas e alterações seguras. Idempotency-Key em todos os POST; ETag nos recursos individuais, If-None-Match e If-Match.
  • Cabeçalhos de limite de pedidos. RateLimit, RateLimit-Policy e X-RateLimit-* em todas as respostas, Retry-After com um 429.
  • Novas operações: a área de trabalho; criar eventos em rascunho, alterar os seus dados básicos e publicá-los; estatísticas do evento e o ritmo de vendas; tipos de bilhete (e alterá-los), complementos e códigos de desconto (e criá-los); uma encomenda; pesquisar participantes; contagens nas portas; sessões (e adicioná-las e alterá-las), salas, áreas temáticas e oradores; patrocinadores e níveis de patrocínio; propostas ao convite a oradores; equipa operacional e turnos; inquéritos, os seus resultados e avaliações de sessões; faturas e notas de crédito; o resumo do orçamento; a classificação do kit de partilha; comunidades e os seus membros; pontos de acesso de webhooks, as suas entregas, testes e segredos, e os tipos de evento com os JSON schemas dos seus payloads.
  • Módulos. Um módulo desligado num evento responde 409 moduleOff nas suas rotas. Isto aplica-se também às portas, às leituras nas portas e ao registo de entrada (o módulo de registo de entrada) e aos contactos comerciais (o módulo de contactos comerciais), que antes respondiam normalmente.
  • Pessoas. Sem people:read, participantes, compradores, equipa operacional e membros são ids; os contactos comerciais e a pesquisa de participantes precisam dele. Quem eliminou os seus dados fica erased, sem nada pessoal.
  • Descrições. /api/v1/openapi.json é agora OpenAPI 3.1, com exemplos e todas as recusas; a descrição Swagger 2.0 que a Power Platform importa está em /api/v1/swagger.json.
  • O servidor MCP em /mcp, para assistentes de IA.

2026-10-12: v1.0

  • Eventos, participantes com as suas respostas, encomendas e leituras nas portas de uma área de trabalho, com updatedSince.
  • Inscrever alguém com um bilhete gratuito, cancelar um bilhete e registar a entrada de alguém.
  • Subscrições para o Power Automate, o Zapier e o Make (/hooks), e webhooks assinados à maneira Standard Webhooks.
  • Perguntas de inscrição, o seu JSON schema, tipos de bilhete, portas e contactos comerciais recentes, para os seletores e campos dos fluxos.

Os guias e este site estão no seu idioma. As descrições da própria referência da API estão em inglês, tal como a própria API.