{"openapi":"3.1.0","info":{"title":"EAN Images API","version":"1.0.0","description":"Imagens e dados de produtos por EAN/GTIN. Consultar disponibilidade e gratis; liberar imagem ou dados consome creditos uma unica vez por produto — downloads seguintes do mesmo produto sao gratuitos."},"servers":[{"url":"https://api.eanimages.com.br"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Disponibilidade","description":"Gratis"},{"name":"Produtos","description":"Consome creditos na primeira liberacao"},{"name":"Conta"}],"paths":{"/v1/availability/{ean}":{"get":{"tags":["Disponibilidade"],"summary":"Consulta a disponibilidade de um EAN","description":"Funciona sem chave (limite de 20/min por IP). Com chave, informa tambem o que sua conta ja liberou.","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"ean","in":"path","required":true,"schema":{"type":"string","example":"7896279102544"},"description":"EAN-8, UPC-A (12), EAN-13 ou GTIN-14"},{"name":"preview","in":"query","schema":{"type":"boolean"},"description":"Inclui URL de preview (baixa resolucao)"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Availability"}}}},"400":{"description":"EAN invalido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisicoes ou quota diaria","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/availability":{"post":{"tags":["Disponibilidade"],"summary":"Consulta ate 1000 EANs de uma vez","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["eans"],"properties":{"eans":{"type":"array","maxItems":1000,"items":{"type":"string"}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"object","properties":{"requested":{"type":"integer"},"valid":{"type":"integer"},"invalid":{"type":"integer"},"duplicatesRemoved":{"type":"integer"},"available":{"type":"integer"},"withImage":{"type":"integer"},"withData":{"type":"integer"},"creditsToUnlockAll":{"type":"integer"}}},"items":{"type":"array","items":{"$ref":"#/components/schemas/Availability"}},"invalid":{"type":"array","items":{"type":"string"}}}}}}},"401":{"description":"Chave ausente ou invalida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Limite de requisicoes ou quota diaria","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/unlock":{"post":{"tags":["Produtos"],"summary":"Libera imagem e/ou dados de ate 100 EANs","description":"Cobra apenas recursos disponiveis e ainda nao liberados pela conta. Repetir a chamada nao cobra de novo. Consome primeiro a cota do plano mensal (se houver) e depois creditos avulsos. Se a soma nao cobrir o total, nada e cobrado (402 INSUFFICIENT_CREDITS ou PLAN_QUOTA_EXCEEDED). Conteudo ja liberado continua acessivel em GET /v1/products/{ean} mesmo sem cota.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["eans"],"properties":{"eans":{"type":"array","maxItems":100,"items":{"type":"string"}},"include":{"type":"array","items":{"type":"string","enum":["image","data"]},"default":["image","data"]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"creditsCharged":{"type":"integer"},"balance":{"type":"integer"},"test":{"type":"boolean"},"invalid":{"type":"array","items":{"type":"string"}}}}}}},"402":{"description":"Creditos insuficientes (INSUFFICIENT_CREDITS) ou cota do plano esgotada/vencida (PLAN_QUOTA_EXCEEDED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/{ean}":{"get":{"tags":["Produtos"],"summary":"Conteudo ja liberado de um produto (gratis)","parameters":[{"name":"ean","in":"path","required":true,"schema":{"type":"string","example":"7896279102544"},"description":"EAN-8, UPC-A (12), EAN-13 ou GTIN-14"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"404":{"description":"Produto nao existe no catalogo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/products/{ean}/image":{"get":{"tags":["Produtos"],"summary":"Redireciona (302) para o download da imagem liberada (gratis)","parameters":[{"name":"ean","in":"path","required":true,"schema":{"type":"string","example":"7896279102544"},"description":"EAN-8, UPC-A (12), EAN-13 ou GTIN-14"}],"responses":{"302":{"description":"Redireciona para URL temporaria do arquivo"},"403":{"description":"Imagem nao liberada para a conta","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/account":{"get":{"tags":["Conta"],"summary":"Saldo, custos e quota diaria","responses":{"200":{"description":"OK"}}}},"/v1/pricing":{"get":{"tags":["Conta"],"summary":"Pacotes de creditos e custo por recurso","security":[{}],"responses":{"200":{"description":"OK"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Chave de API: eani_live_... (producao) ou eani_test_... (testes, nao cobra). Tambem aceita o header X-API-Key."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"INSUFFICIENT_CREDITS"},"message":{"type":"string"},"details":{},"requestId":{"type":"string"}}}}},"Availability":{"type":"object","properties":{"ean":{"type":"string"},"available":{"type":"boolean"},"image":{"type":"object","properties":{"available":{"type":"boolean"},"format":{"type":["string","null"],"example":"png"},"credits":{"type":"integer"},"unlocked":{"type":"boolean","description":"Somente com autenticacao"}}},"data":{"type":"object","properties":{"available":{"type":"boolean"},"hasName":{"type":"boolean"},"hasDescription":{"type":"boolean"},"credits":{"type":"integer"},"unlocked":{"type":"boolean"}}},"previewUrl":{"type":["string","null"]}}},"Product":{"type":"object","properties":{"ean":{"type":"string"},"found":{"type":"boolean"},"creditsCharged":{"type":"integer"},"image":{"type":"object","properties":{"available":{"type":"boolean"},"unlocked":{"type":"boolean"},"charged":{"type":"boolean"},"credits":{"type":"integer"},"format":{"type":"string"},"filename":{"type":"string"},"downloadUrl":{"type":"string","description":"URL temporaria (expira em expiresAt)"},"expiresAt":{"type":"string","format":"date-time"}}},"data":{"type":"object","properties":{"available":{"type":"boolean"},"unlocked":{"type":"boolean"},"charged":{"type":"boolean"},"credits":{"type":"integer"},"name":{"type":["string","null"]},"descriptionHtml":{"type":["string","null"]},"descriptionText":{"type":["string","null"]}}}}}}}}