Docs Publica

API publica de receitas

Esta documentacao e exclusiva para consumo publico de receitas. Nao inclui endpoints administrativos ou internos do sistema.

Autenticacao

Envie sua API key no header X-API-KEY em todas as requisicoes.

X-API-KEY: sua_chave_aqui

Base URL

https://receitaspro.uway.com.br/api/v1

Formato

JSON UTF-8

Escopo publico

Listagem e busca de receitas publicadas.

GET /recipes

Lista receitas publicadas e tambem realiza busca por termo/categoria via query string.

Query params

search: termo para buscar no titulo da receita
category: slug da categoria
per_page: itens por pagina (1 a 50)

Exemplo (index)

curl -H "X-API-KEY: SUA_CHAVE" "https://receitaspro.uway.com.br/api/v1/recipes"

Exemplo (busca)

curl -H "X-API-KEY: SUA_CHAVE" "https://receitaspro.uway.com.br/api/v1/recipes?search=bolo&category=doces&per_page=12"

Resposta resumida

{
  "data": [
    {
      "id": 1,
      "title": "Bolo de cenoura",
      "slug": "bolo-de-cenoura-ab12cd",
      "difficulty": "Facil",
      "total_time": "50min",
      "servings_quantity": 8,
      "servings_unit": "porcoes",
      "servings": "8 porcoes",
      "image_url": "https://...",
      "category": {"id": 3, "name": "Doces", "slug": "doces"}
    }
  ],
  "links": {"first": "...", "last": "...", "prev": null, "next": "..."},
  "meta": {"current_page": 1, "last_page": 10, "per_page": 12}
}

Codigos de erro comuns

401 chave ausente/invalida/expirada
422 parametro invalido
429 limite de requisicoes excedido (quando aplicavel)