Passar para o conteúdo principal

Melhorias na API Pública: Autenticação Simplificada e Novos Endpoints para Ordens e Orçamentos

Saiba mais sobre as últimas atualizações do Orderry

Hanna avatar
Escrito por Hanna
Atualizado há mais de uma semana

Confira as melhorias mais recentes da API Pública do Orderry, criadas para facilitar integrações e automações com serviços de terceiros.

Autenticação simplificada com Bearer Token

Agora você pode autenticar requisições usando autenticação Bearer padrão:

Authorization: Bearer YOUR_API_KEY

Isso simplifica e acelera o processo de integração.

Importante: O método antigo (POST /token/new) está obsoleto e será desativado em 1º de setembro de 2025. Migre com antecedência para evitar interrupções.

Novos endpoints para ordens e orçamentos

Reestruturamos a API e adicionamos novos endpoints mais flexíveis e compatíveis com REST.

Os métodos antigos estarão disponíveis até 1º de setembro de 2025, mas já são considerados obsoletos.

Lista de itens como recurso separado

Produtos e serviços agora são tratados como um recurso separado:

  • GET /orders/{id} — detalhes gerais da ordem

  • GET /orders/{id}/items — lista de itens

  • POST /orders/{id}/items — adiciona item (productos sem baixa de estoque)

  • PATCH /orders/{id}/items/{item_id} — atualiza o item

Mesma estrutura para orçamentos: /estimates/{id}/items

Essa melhoria estabelece a base para integrações com lojas virtuais e marketplaces, onde os pedidos importados incluirão uma lista completa de itens. Já estamos trabalhando em uma integração direta com o Shopify. Você também pode usar esses endpoints para conectar o Orderry à sua própria plataforma de e-commerce.

Novo formato de data ISO 8601

Todos os novos endpoints agora utilizam o formato de data ISO 8601. Exemplo:

"createdAt": "2025-05-14T08:35:05Z"

Paginação flexível com pageSize

Endpoints GET /orders e GET /estimates agora aceitam pageSize:

  • Valores permitidos: de 10 a 100

  • Padrão: pageSize=50

Reduza para respostas mais rápidas ou aumente para obter mais dados por requisição.

Envie seu feedback ou sugestões via chat com o Suporte.

Respondeu à sua pergunta?