// docs
Extrai produtos Samsung com preço atual, preço de referência, pagamento à vista, parcelamento, imagens, ficha técnica, EAN e variações. Cada consulta PDP custa 1 crédito.
Tempo de resposta: Preço e disponibilidade refletem o catálogo sem CEP. Avaliações e frete não são fornecidos. Campos não informados pela origem são null; listas podem ser vazias. O exemplo resume a galeria e os atributos da resposta. Valores monetários em BRL: price é o preço atual; regularPrice é o preço de referência; cashPrice é a menor oferta publicada em uma parcela, incluindo Pix quando informado. installmentPrice e installmentCount correspondem ao maior parcelamento sem juros no cartão. Preços de ofertas indisponíveis são null. Cupons, troca de aparelho e descontos de clubes não são calculados.
Nota importante: alguns campos podem retornar null em produção,
dependendo da página de origem. Consulte o schema e a descrição de cada campo
para tratar valores ausentes; os exemplos mostram uma resposta possível.
Quando a entidade consultada não existe na origem, o extract e a tool MCP retornam
200 com data: null e
notFound: true. Esse caso é tratado como resposta concluída,
não como erro de servidor.
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"target": "samsung.com.br",
"type": "pdp",
"url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p"
}'
A mesma seam também aparece no MCP hospedado como uma tool dedicada.
Os argumentos reaproveitam os campos do extract, mas target e type
já ficam fixos pela tool.
Endpoint
POST /v1/mcp
Tool name
samsung_com_br_pdp
Auth
Bearer ou X-API-Key
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "samsung_com_br_pdp",
"arguments": {
"url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p",
"executionId": "exec_example_123"
}
}
}
Campos suportados nesta API do POST /v1/extract,
com regras específicas de obrigatoriedade e condicionais.
| Campo | Tipo | Status | Regra | Default | Exemplo |
|---|---|---|---|---|---|
| url URL alvo da extração. Para alguns PLPs pode ser omitida quando a API monta a URL a partir de outros campos. | string (URL) | Obrigatório | URL da loja Samsung Brasil em shop.samsung.com/br/slug/p (ou shop.samsung.com.br/slug/p), opcionalmente com ?skuId=ID. O SKU deve pertencer ao produto. Parâmetros de rastreamento do Google e utm_* são removidos. | - | https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p |
| target Fonte alvo da extração. | enum | Obrigatório | Use samsung.com.br. | samsung.com.br | samsung.com.br |
| type Tipo da extração: pdp, idp, plp, ilp, quote, review ou places. | enum | Obrigatório | Use pdp. | pdp | pdp |
Cada consulta PDP custa 1 crédito. Sem skuId, seleciona a primeira variação disponível, ou a primeira se todas estiverem indisponíveis.
{
"target": "samsung.com.br",
"type": "pdp",
"url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p"
}Use uma URL de variants[].url para consultar a oferta daquela variação.
{
"target": "samsung.com.br",
"type": "pdp",
"url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8454"
}Mapa de paths de saída com tipo esperado para esta API.
{
"requestId": "string",
"executionId": "string",
"data.extractedAt": "string",
"data.canonicalUrl": "string",
"data.url": "string",
"data.productId": "string",
"data.sku": "string",
"data.name": "string",
"data.price": "number | null",
"data.regularPrice": "number | null",
"data.cashPrice": "number | null",
"data.installmentPrice": "number | null",
"data.installmentCount": "number | null",
"data.sellerName": "string | null",
"data.sellerId": "string | null",
"data.sellerUrl": "null",
"data.availability": "string | null",
"data.currency": "string",
"data.currencyRaw": "string",
"data.description": "string | null",
"data.descriptionHtml": "string | null",
"data.images[].url": "string",
"data.mainImage.url": "string",
"data.brand.name": "string",
"data.aggregateRating": "null",
"data.breadcrumbs[].name": "string",
"data.additionalProperties[].name": "string",
"data.additionalProperties[].value": "string",
"data.additionalProperties[].section": "string | null",
"data.variants[].sku": "string",
"data.variants[].name": "string",
"data.variants[].url": "string",
"data.variants[].image": "string | null",
"data.variants[].voltage": "string | null",
"data.variants[].ean": "string | null",
"data.variants[].available": "boolean | null",
"data.variants[].price": "number | null",
"data.variants[].regularPrice": "number | null",
"data.variants[].cashPrice": "number | null",
"data.variants[].installmentPrice": "number | null",
"data.variants[].installmentCount": "number | null",
"data.variants[].sellerId": "string | null",
"data.variants[].sellerName": "string | null",
"data.color": "string | null",
"data.size": "string | null",
"data.voltage": "string | null",
"data.otherSellers": "array",
"data.mpn": "string | null",
"data.features[]": "string",
"data.ean": "string | null",
"data.shippingDetails": "null",
"data.variants[].color": "string | null",
"data.variants[].size": "string | null"
}{
"requestId": "d68564d2-34bc-47e6-a1a6-796794f8463b",
"executionId": "f7b0f7f6-3363-4958-9f7e-6c0e0d189874",
"data": {
"extractedAt": "2026-10-01T12:17:16.267Z",
"canonicalUrl": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p",
"url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8453",
"productId": "6368",
"sku": "8453",
"name": "Celular Samsung Galaxy S25 Ultra 5G, 512GB, 12GB RAM, Câmera Quádrupla de 200+50+10+50, Tela Grande de 6.9\"",
"price": 6899,
"regularPrice": 12099,
"cashPrice": 6209.1,
"installmentPrice": 383.27,
"installmentCount": 18,
"sellerName": "SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA.",
"sellerId": "1",
"sellerUrl": null,
"availability": "InStock",
"currency": "BRL",
"currencyRaw": "R$",
"description": "Celular Samsung Galaxy S25 Ultra 5G, 512GB, 12GB RAM, Galaxy AI, inteligencia artificial, comando e tradução de voz, Câmera Quádrupla de 200+50+10+50, Tela Grande de 6.9\" Bateria 5000mAh, Dual Chip, eSim; A Samsung apresenta o mais novo lançamento da linha S. Seu verdadeiro aliado AI, o Galaxy S25 é o novo celular com o poder da nova geração da inteligência artificial. Tenha em suas mãos uma nova experiência com Galaxy AI com seus novos recursos. Eleve o seu dia a dia, com assistência rápida e completa com os novos recursos de IA mais avançados, como traduções em tempo real, geração de texto e imagens, tudo isso com maior rapidez e privacidade, graças à execução de tarefas diretamente no dispositivo. Novas formas de realizar suas tarefas, se divertir, criar e cuidar da sua saúde. Um celular AI totalmente novo que auxilia sua vida diária com conversas em linguagem natural. Celular AI semelhante ao humano alimentado por agentes de IA e com diversos recursos ao seu alcance, com o Gemini Live, conclua instantaneamente várias tarefas de uma só vez com uma conversa natural tendo uma ação entre aplicativos. Conclua várias ações de uma só vez, falando naturalmente com a série Galaxy S25, que entende seus comandos de voz. Sincronize suas mensagens, calendários, texto apenas ativando um único comando. Obtenha facilmente informações, ações e soluções de que você precisa com base no contexto da sua tela. Encontre intuitivamente as informações de que você precisa com pesquisa na tela ou circule para pesquisar. A nova função Now Bar & Now Brief, ainda permite que você verifique as notificações para tarefas em andamento e receba um resumo diário de suas atividades. O Gravador de chamada é mais uma novidade no Galaxy S25, permite que você faça gravação de chamadas com transcrição e resumo no dispositivo. O Novo Galaxy S25 ainda conta com o processador mais poderoso da linha S. O Snapdragon 8 Elite for Galaxy (3nm) tem seu desempenho aprimorado de forma abrangente, oferecendo uma experiência móvel poderosa. O processamento de IA mais rápido em um Galaxy, fornecendo resultados de IA mais confiáveis do que nunca. Falando de câmera o novo Galaxy S25, permite que você tenha novas experiências de filmar e fotografar surpreendente com detalhes e cores mais vibrantes. Tenha o maior nível de detalhes em suas fotos e vídeos, independentemente da lente que você estiver usando. Vídeos Nightography destacam inúmeros detalhes. Imagens vibrantes e realistas, Reconhecimento perfeito do tom de pele com o Object-Aware Engine. O Assistente de fotografia dentro do novo Galaxy S25 ainda conta com novas funcionalidades. O eliminador de áudio ajuda a remover ruídos indesejados em seus vídeos e a uma nova função para você reproduzir a magia do cinema no Studio combinando fotos e vídeos da galeria em novos projetos de filmes. A linha Galaxy S25 ainda conta com a sua identidade de design única da série S, ultra elegante, molduras mais finas e uniformes para visualização mais ampla e usabilidade mais confortável. Sua durabilidade excepcional possui materiais meticulosamente selecionados para um design premium e durável. Seu acabamento em alumínio forte com dureza incrível para o S25 e S25+. E para a versão Ultra acabamento em Titânio. O metal mais resistente já usado na série Galaxy. Vidro resistente “Corning Gorilla Armor” para maior durabilidade (Resistência a arranhões e choques). Brilho adaptável garantindo uma visualização suave e confortável. O novo Galaxy ainda conta com um mix de Cores luminosas inspiradas na natureza, sendo elas: Azul, Verde, Prata e Azul Marinho para a versão básica e Plus. Já nas versões do modelo Ultra, as cores são Titânio Preto, Titânio Cinza, Titânio Prata, Titânio Azul. Com o aplicativo Smart Switch você transfere de forma fácil e prática o conteúdo do seu celular anterior (fotos, contatos, eventos do calendário, notas, configurações do dispositivo e muito mais) para o novo Galaxy S25. Para sua melhor segurança não deixe de conferir as ativações do Cadeado Galaxy, tenha seus dados e seu celular seguro e protegido.",
"descriptionHtml": null,
"images": [
{
"url": "https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000"
},
{
"url": "https://samsungbrshop.vteximg.com.br/arquivos/ids/249974/03-Galaxy_S25_Ultra_Now_Brief.jpg?v=638793925734830000"
}
],
"mainImage": {
"url": "https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000"
},
"brand": {
"name": "Samsung"
},
"aggregateRating": null,
"breadcrumbs": [
{
"name": "Mobile"
},
{
"name": "Smartphone"
},
{
"name": "Galaxy S"
}
],
"additionalProperties": [
{
"name": "BRAND",
"value": "Samsung",
"section": "Samsung.com"
},
{
"name": "MODEL",
"value": "SM-S938B/DS",
"section": "Samsung.com"
},
{
"name": "RAM",
"value": "12GB",
"section": "Samsung.com"
},
{
"name": "Linha",
"value": "Galaxy S",
"section": "Samsung.com"
},
{
"name": "Tamanho da tela",
"value": "6.9\"",
"section": "Samsung.com"
},
{
"name": "Tecnologia da Tela",
"value": "Dynamic AMOLED 2X",
"section": "Samsung.com"
},
{
"name": "Resolução da tela",
"value": "3120 x 1440 (QHD+)",
"section": "Samsung.com"
},
{
"name": "Com leitor de impressão digital",
"value": "Sim",
"section": "Samsung.com"
}
],
"variants": [
{
"sku": "8453",
"name": "Titânio Preto",
"url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8453",
"image": "https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000",
"voltage": null,
"ean": "7892509139724",
"color": "Titânio Preto",
"size": "512 GB",
"available": true,
"price": 6899,
"regularPrice": 12099,
"cashPrice": 6209.1,
"installmentPrice": 383.27,
"installmentCount": 18,
"sellerId": "1",
"sellerName": "SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA."
},
{
"sku": "8454",
"name": "Titânio Cinza",
"url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8454",
"image": "https://samsungbrshop.vteximg.com.br/arquivos/ids/249979/S25_1000x1000__0002_S25-ultra_titanio_cinza.jpg.jpg?v=638793927258030000",
"voltage": null,
"ean": "7892509139694",
"color": "Titânio Cinza",
"size": "512 GB",
"available": true,
"price": 6899,
"regularPrice": 12099,
"cashPrice": 6209.1,
"installmentPrice": 383.27,
"installmentCount": 18,
"sellerId": "1",
"sellerName": "SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA."
}
],
"color": "Titânio Preto",
"size": "512 GB",
"voltage": null,
"otherSellers": [],
"mpn": "SM-S938BZKKZTO",
"features": [
"Galaxy S25 Series. Seu verdadeiro aliado AI. Galaxy AI",
"A melhor experiência em fotografia e edição",
"O processador mais poderoso feito sob medida para o Galaxy"
],
"ean": "7892509139724",
"shippingDetails": null
}
}| Path | Tipo | Descrição | Exemplo |
|---|---|---|---|
| data.additionalProperties[].name | string | Nome da especificação publicada. | BRAND |
| data.additionalProperties[].section | string | null | Grupo da especificação, quando informado. | Samsung.com |
| data.additionalProperties[].value | string | Valor textual da especificação. | Samsung |
| data.aggregateRating | null | Avaliação agregada; null porque o catálogo consultado não fornece avaliações. | null |
| data.availability | string | null | InStock ou OutOfStock; null quando a origem não informa. | InStock |
| data.brand.name | string | Nome da marca do produto. | Samsung |
| data.breadcrumbs[].name | string | Nome de uma categoria no caminho do produto. | Mobile |
| data.canonicalUrl | string | URL canônica do produto sem seleção de SKU. | https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p |
| data.cashPrice | number | null | Menor valor em uma parcela publicado na oferta; não pressupõe desconto no Pix. | 6209.1 |
| data.color | string | null | Cor informada no catálogo. | Titânio Preto |
| data.currency | string | Moeda da oferta: BRL. | BRL |
| data.currencyRaw | string | Símbolo da moeda: R$. | R$ |
| data.description | string | null | Descrição textual do produto, com tags HTML removidas. | Celular Samsung Galaxy S25 Ultra 5G, 512GB, 12GB RAM, Galaxy AI, inteligencia artificial, comando e tradução de voz, Câmera Quádrupla de 200+50+10+50, Tela Grande de 6.9" Bateria 5000mAh, Dual Chip, eSim; A Samsung apresenta o mais novo lançamento da linha S. Seu verdadeiro aliado AI, o Galaxy S25 é o novo celular com o poder da nova geração da inteligência artificial. Tenha em suas mãos uma nova experiência com Galaxy AI com seus novos recursos. Eleve o seu dia a dia, com assistência rápida e completa com os novos recursos de IA mais avançados, como traduções em tempo real, geração de texto e imagens, tudo isso com maior rapidez e privacidade, graças à execução de tarefas diretamente no dispositivo. Novas formas de realizar suas tarefas, se divertir, criar e cuidar da sua saúde. Um celular AI totalmente novo que auxilia sua vida diária com conversas em linguagem natural. Celular AI semelhante ao humano alimentado por agentes de IA e com diversos recursos ao seu alcance, com o Gemini Live, conclua instantaneamente várias tarefas de uma só vez com uma conversa natural tendo uma ação entre aplicativos. Conclua várias ações de uma só vez, falando naturalmente com a série Galaxy S25, que entende seus comandos de voz. Sincronize suas mensagens, calendários, texto apenas ativando um único comando. Obtenha facilmente informações, ações e soluções de que você precisa com base no contexto da sua tela. Encontre intuitivamente as informações de que você precisa com pesquisa na tela ou circule para pesquisar. A nova função Now Bar & Now Brief, ainda permite que você verifique as notificações para tarefas em andamento e receba um resumo diário de suas atividades. O Gravador de chamada é mais uma novidade no Galaxy S25, permite que você faça gravação de chamadas com transcrição e resumo no dispositivo. O Novo Galaxy S25 ainda conta com o processador mais poderoso da linha S. O Snapdragon 8 Elite for Galaxy (3nm) tem seu desempenho aprimorado de forma abrangente, oferecendo uma experiência móvel poderosa. O processamento de IA mais rápido em um Galaxy, fornecendo resultados de IA mais confiáveis do que nunca. Falando de câmera o novo Galaxy S25, permite que você tenha novas experiências de filmar e fotografar surpreendente com detalhes e cores mais vibrantes. Tenha o maior nível de detalhes em suas fotos e vídeos, independentemente da lente que você estiver usando. Vídeos Nightography destacam inúmeros detalhes. Imagens vibrantes e realistas, Reconhecimento perfeito do tom de pele com o Object-Aware Engine. O Assistente de fotografia dentro do novo Galaxy S25 ainda conta com novas funcionalidades. O eliminador de áudio ajuda a remover ruídos indesejados em seus vídeos e a uma nova função para você reproduzir a magia do cinema no Studio combinando fotos e vídeos da galeria em novos projetos de filmes. A linha Galaxy S25 ainda conta com a sua identidade de design única da série S, ultra elegante, molduras mais finas e uniformes para visualização mais ampla e usabilidade mais confortável. Sua durabilidade excepcional possui materiais meticulosamente selecionados para um design premium e durável. Seu acabamento em alumínio forte com dureza incrível para o S25 e S25+. E para a versão Ultra acabamento em Titânio. O metal mais resistente já usado na série Galaxy. Vidro resistente “Corning Gorilla Armor” para maior durabilidade (Resistência a arranhões e choques). Brilho adaptável garantindo uma visualização suave e confortável. O novo Galaxy ainda conta com um mix de Cores luminosas inspiradas na natureza, sendo elas: Azul, Verde, Prata e Azul Marinho para a versão básica e Plus. Já nas versões do modelo Ultra, as cores são Titânio Preto, Titânio Cinza, Titânio Prata, Titânio Azul. Com o aplicativo Smart Switch você transfere de forma fácil e prática o conteúdo do seu celular anterior (fotos, contatos, eventos do calendário, notas, configurações do dispositivo e muito mais) para o novo Galaxy S25. Para sua melhor segurança não deixe de conferir as ativações do Cadeado Galaxy, tenha seus dados e seu celular seguro e protegido. |
| data.descriptionHtml | string | null | Descrição HTML publicada pela origem; sanitize antes de exibir como HTML. | null |
| data.ean | string | null | EAN da variação, quando informado. | 7892509139724 |
| data.extractedAt | string | Data e hora da extração em ISO 8601. | 2026-10-01T12:17:16.267Z |
| data.features[] | string | Destaques publicados no catálogo. | Galaxy S25 Series. Seu verdadeiro aliado AI. Galaxy AI |
| data.images[].url | string | URL da imagem do SKU selecionado. | https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000 |
| data.installmentCount | number | null | Quantidade de parcelas sem juros em cartão de crédito dessa opção. | 18 |
| data.installmentPrice | number | null | Valor da parcela da opção com mais parcelas sem juros em cartão de crédito, quando disponível. | 383.27 |
| data.mainImage.url | string | URL da imagem do SKU selecionado. | https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000 |
| data.mpn | string | null | Referência do fabricante para a variação; usa a referência do produto como alternativa. | SM-S938BZKKZTO |
| data.name | string | Nome publicado pela origem. | Celular Samsung Galaxy S25 Ultra 5G, 512GB, 12GB RAM, Câmera Quádrupla de 200+50+10+50, Tela Grande de 6.9" |
| data.otherSellers | array | Outros vendedores da mesma variação, quando presentes. | [] |
| data.price | number | null | Preço atual em reais; null quando a oferta está indisponível ou sem preço. | 6899 |
| data.productId | string | Identificador do produto no catálogo Samsung. | 6368 |
| data.regularPrice | number | null | Preço de referência em reais, quando informado. | 12099 |
| data.sellerId | string | null | Identificador do vendedor da oferta. | 1 |
| data.sellerName | string | null | Nome do vendedor da oferta. | SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA. |
| data.sellerUrl | null | URL do vendedor quando disponível; atualmente null nesta origem. | null |
| data.shippingDetails | null | null: esta API não calcula frete nem disponibilidade por CEP. | null |
| data.size | string | null | Memória ou tamanho do SKU selecionado, quando informado. | 512 GB |
| data.sku | string | Identificador da variação (SKU); voltagens diferentes podem ter SKUs distintos. | 8453 |
| data.url | string | URL pública; no produto, skuId identifica a variação selecionada. | https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8453 |
| data.variants[].available | boolean | null | Disponibilidade do SKU selecionado; null quando a origem não informa. | true |
| data.variants[].cashPrice | number | null | Menor valor em uma parcela publicado na oferta; não pressupõe desconto no Pix. | 6209.1 |
| data.variants[].color | string | null | Cor publicada para a variação, quando informada. | Titânio Preto |
| data.variants[].ean | string | null | EAN da variação, quando informado. | 7892509139724 |
| data.variants[].image | string | null | Imagem principal da variação. | https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000 |
| data.variants[].installmentCount | number | null | Quantidade de parcelas sem juros em cartão de crédito dessa opção. | 18 |
| data.variants[].installmentPrice | number | null | Valor da parcela da opção com mais parcelas sem juros em cartão de crédito, quando disponível. | 383.27 |
| data.variants[].name | string | Nome da variação, incluindo cor ou voltagem quando informado. | Titânio Preto |
| data.variants[].price | number | null | Preço atual em reais; null quando a oferta está indisponível ou sem preço. | 6899 |
| data.variants[].regularPrice | number | null | Preço de referência em reais, quando informado. | 12099 |
| data.variants[].sellerId | string | null | Identificador do vendedor da oferta. | 1 |
| data.variants[].sellerName | string | null | Nome do vendedor da oferta. | SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA. |
| data.variants[].size | string | null | Memória ou tamanho publicado para a variação, quando informado. | 512 GB |
| data.variants[].sku | string | Identificador da variação (SKU); voltagens diferentes podem ter SKUs distintos. | 8453 |
| data.variants[].url | string | URL pública com skuId para consultar essa variação no PDP. | https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8453 |
| data.variants[].voltage | string | null | Voltagem da variação, como 110V, 220V ou Bivolt, quando informada. | null |
| data.voltage | string | null | Voltagem da variação, como 110V, 220V ou Bivolt, quando informada. | null |
| executionId | string | Identificador da execução do worker. | f7b0f7f6-3363-4958-9f7e-6c0e0d189874 |
| requestId | string | Identificador da requisição HTTP na GeckoAPI. | d68564d2-34bc-47e6-a1a6-796794f8463b |
Respostas com notFound: true não entram nesta tabela,
porque retornam sucesso HTTP 200.
| Status | errorCode | Quando acontece |
|---|---|---|
| 400 | INVALID_PAYLOAD | JSON inválido ou violação das regras de validação do payload. |
| 401 | UNAUTHORIZED | Header Authorization ausente ou token/chave inválida. |
| 402 | INSUFFICIENT_CREDITS | Saldo de créditos insuficiente para a API solicitada. |
| 403 | FORBIDDEN | Usuário sem acesso ou API temporariamente desabilitada. |
| 409 | EXECUTION_CONFLICT | executionId conflita com uma execução em estado incompatível. |
| 429 | RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS | Limite de taxa ou limite de requisições em voo excedido. |
| 5xx | UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR | Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente. |