Comece aqui

Uma chave de API, um identificador GS1 para o produto e o próprio registo de produto. Se ainda não tiver identificadores GS1, essa é a primeira dependência a resolver: vêm da sua organização membro GS1, não de nós, porque a identidade tem de ser globalmente única fora da nossa plataforma.

Sim. As chaves têm âmbito por ambiente, pelo que as chaves de sandbox não conseguem tocar em passaportes de produção e as de produção não podem ser usadas por engano num banco de testes. Os passaportes de sandbox resolvem exatamente como os de produção, contra um nome de anfitrião de resolvedor separado.

JSON sobre HTTPS para a API. Os eventos seguem a serialização JSON-LD do GS1 EPCIS 2.0, e as credenciais o modelo de dados W3C Verifiable Credentials 2.0. Onde uma norma define uma representação, usamo-la em vez de inventar uma, o que significa que as ferramentas existentes para essas normas funcionam com o nosso resultado.

A API devolve códigos de estado HTTP convencionais com um corpo de erro estruturado que identifica o campo e a restrição não cumprida. Os erros de validação são devolvidos por inteiro em vez de um de cada vez, pelo que um registo malformado revela todos os problemas numa resposta em vez de em cinco idas e voltas.

Pelo canal de apoio associado à sua conta, ou pela via de contacto se ainda estiver em avaliação. As perguntas de integração que revelam uma lacuna na documentação são tratadas como defeitos de documentação, que é a única forma de uma referência se manter exata à medida que a API cresce.