Consultar produto

GET /api/v1/produtos/{id}

Retorna um produto somente quando ele pertence ao produtor autenticado.

GET Requisição

bash

curl -X GET "https://ev.paylog.cash/api/v1/produtos/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

javascript

const response = await fetch("https://ev.paylog.cash/api/v1/produtos/{id}", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
  },
});

python

import requests

response = requests.get(
    "https://ev.paylog.cash/api/v1/produtos/{id}",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
    },
)

ruby

require "net/http"
require "json"
require "uri"

uri = URI("https://ev.paylog.cash/api/v1/produtos/{id}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_TOKEN"
request["Accept"] = "application/json"

response = http.request(request)

200 Resposta

json

{
  "id": 0,
  "nome": "string",
  "status": 0,
  "estoque": 0
}

Parâmetros

Caminho

id integer Obrigatório: ID interno do produto.

Respostas

200

Produto encontrado.

application/json

object

id integer Obrigatório

ID interno do produto.
nome string Obrigatório

Nome do produto.
status integer Obrigatório

0 pendente ou 1 aprovado.

Valores permitidos 0 1
estoque integer Obrigatório

Saldo de estoque disponível.

204

Produto inexistente ou não pertencente ao produtor. A resposta não possui corpo.

401

Token Bearer ausente ou inválido.

application/json

object

Mensagem de erro ou informação. Alguns erros legados omitem code.

code integer

Código numérico quando fornecido pelo endpoint.
message string

Mensagem legível.

403

O token é válido, mas a conta não possui a permissão necessária para esta operação. O envelope é gerado pelo tratador global de exceções e usa a chave errors (string), não message.

application/json

object

Envelope produzido pelo tratador global de exceções para falhas HTTP que não são geradas pelos controladores — principalmente 403 (permissão ausente) e 405 (verbo não suportado). Difere dos erros dos controladores por usar errors no lugar de message.

errors string Obrigatório

Mensagem da exceção HTTP.
code integer Obrigatório

Código HTTP repetido no corpo.

500

Falha interna nas rotas legadas de pacotes e produtos. O corpo NÃO é JSON: os controladores devolvem o texto puro Algo deu errado!. Falhas que escapam do catch do controlador (erro fatal de PHP) caem no tratador do framework e devolvem {"message":"Server Error"} em JSON. Trate 500 pelo código HTTP, nunca pelo corpo.

text/plain

string

application/json

object

Mensagem de erro ou informação. Alguns erros legados omitem code.

code integer

Código numérico quando fornecido pelo endpoint.
message string

Mensagem legível.