⏱️Histórico de Alterações

Aqui você encontra o histórico de alterações dessa documentação, onde realizamos manutenções periódicas a fim de manter todos o versionamento por mês e ano para a sua consulta.

janeiro/2025

Abaixo encontram-se as alterações realizadas na v1 da nossa API.

• Inclusão de novo endpoint de Etiquetas

agosto/2024

Abaixo encontram-se as alterações realizadas na v1.1 da nossa API.

• Inclusão de novo endpoint de Listagem de pedidos

abril/2024

Abaixo encontram-se as alterações realizadas na v1 da nossa API.

• Inclusão de novo endpoint de Listagem de produtos

• Inclusão de novo endpoint para Consulta de um produto específico

• Atualização dos exemplos gerais de corpo das requisições na v1 da nossa API

agosto/2023

• Atualização do link da nossa Central de Ajuda

• Atualização dos exemplos gerais de corpo das requisições na v1 da nossa API

novembro/2022

Abaixo encontram-se as alterações realizadas na v1 da nossa API.

• Inclusão de informações e regras relativas aos limites das requisições

• Inclusão do link de acesso aos exemplos de requisições (collections) através da ferramenta Postman

setembro/2022

Abaixo encontram-se as alterações realizadas na v1 da nossa API.

Migração de Ambiente

• URLs de ponto de acesso principais das nossas APIs foram alteradas para:

  • Ambiente de testes: api-stg.estoca.com.br

  • Ambiente de produção: api.estoca.com.br

• Descontinuação da URL plataforma.estoca.com.br como ponto de acesso principal para as nossas APIs

  • É válido citar que essa URL continuará ativa normalmente para os acessos de usuários da nossa plataforma

Alterações de Conceitos

• Autorização das nossas APIs passam a utilizar os cabeçalhos da requisição (Headers) ao invés da utilização direta nos parâmetros de rota (Query Strings)

  • Para isso, deverá ser utilizado o Header X-Api-Key

• Versionamento das nossas APIs passam a utilizar os cabeçalhos da requisição (Headers) ao invés da utilização direta nos caminhos das rotas (Paths)

  • Para isso, deverá ser utilizado o Header X-Api-Version

Alterações de Recursos

Método Antigo	Rota Antiga	Método Novo	Rota Nova
GET	/integration/api/v1/ping	GET	/health-check
POST	/integration/api/v1/create_product	POST	/products
POST	/integration/api/v1/create_product	PUT	/products
POST	/integration/api/v1/get_inbound	GET	/inbounds/{id}
POST	/integration/api/v1/create_inbound	POST	/inbounds
POST	/integration/api/v1/delete_inbound	DELETE	/inbounds/{id}
GET	/integration/api/v1/get_inventory	GET	/inventories
GET	/integration/api/v1/list_orders	GET	/orders
GET	/integration/api/v1/search_order	GET	/orders/{id}
POST	/integration/api/v1/create_order	POST	/orders
POST	/integration/api/v1/create_order	PUT	/orders
POST	/integration/api/v1/upload_order_invoice	POST	/invoices
GET	/integration/api/v1/tracking	GET	/trackings

Alterações de Parâmetros de Rota (Query Strings)

Método e Rota Nova	Parâmetro Antigo	Parâmetro Novo
GET /inventories	warehouse	warehouse
GET /inventories	product_sku	sku
GET /orders	start_date	from
GET /orders	end_date	to
GET /orders	updated_from	updated
GET /trackings	order_id	order
GET /trackings	external_id	id
GET /trackings	tracking_code	code