Saltar al contenido
Mi Tienda

API de ejemplo · JSON

Del catálogo al pedido

Una tienda de ejemplo —productos y pedidos— detrás de una API JSON. Pídala desde su web, su app o su automatismo, y practique filtros, orden y paginación con respuestas de verdad.

  • 30 productos
  • 20 pedidos
  • lectura pública · CORS abierto

02 / 05Producto

GET /products/{id}

Un producto es un objeto

Con su id se pide uno solo. Lo que llega es el mismo objeto que hay en la lista: nada que traducir.

{ "id": 1, "name": "Laptop",
  "price": 12000, "stock": 10 }

03 / 05Pedido

GET /orders/{id}

El pedido lo lleva todo

Fecha, cliente, los productos con su cantidad y el total, en un solo objeto. Los clientes son inventados: es una tienda para practicar.

GET /orders/1001-2024
→ { "date": "2024-06-01", "client": { … }, "products": [ … ], "total": 13000 }

04 / 05Consultar

?filtro · _sort · _page

Pida solo lo que necesita

Filtre por un campo o con _lt, _lte, _gt, _gte y _ne; ordene con _sort (con un guion, al revés); pagine con _page y _per_page.

?price_lte=500?_sort=-price?_page=2

05 / 05Integrar

CORS abierto

Desde la web, el móvil o un flujo

La API responde a cualquier origen: un fetch en el navegador, una app móvil o el nodo HTTP de un automatismo leen lo mismo.

Ver cómo

Integrar

Dos maneras de empezar

La URL base es esta misma página. No hace falta clave para leer.

JavaScript

Desde el navegador

Un fetch desde cualquier origen: la API responde con CORS abierto.

const r = await fetch(
  'https://tienda.alexanderoviedofadul.dev/products?_sort=price')
const productos = await r.json()

curl · automatismos

Desde la terminal o un flujo

La misma petición en un nodo HTTP de un automatismo o en la terminal.

curl -s \
  'https://tienda.alexanderoviedofadul.dev/orders/1001-2024'

Referencia

Las rutas de lectura

MétodoRutaPara qué
GET/productsEl catálogo (admite filtros, orden y paginación)
GET/products/{id}Un producto
GET/ordersLos pedidos
GET/orders/{id}Un pedido, con su cliente, sus productos y el total

Preguntas

Lo que se suele preguntar

¿Los datos son reales?

No. Los productos, los pedidos y los clientes son de ejemplo: la tienda existe para practicar con una API.

¿Hay que registrarse o usar una clave?

No para leer: las rutas de esta página son públicas y responden a cualquier origen.

¿Puedo buscar texto con ?q=?

No: la versión de json-server que la sirve no tiene búsqueda de texto, y ?q= devuelve la lista entera. Use un filtro por campo, como ?name=Laptop.

¿En qué moneda están los precios?

Los datos no lo dicen, así que esta página tampoco: son números de ejemplo.

¿Puedo crear o cambiar productos?

Esta tienda es compartida y está pensada para leer. Para practicar escrituras, levante su propia copia con json-server y el mismo db.json.

Haga la primera consulta

Abra el catálogo o un pedido y mire lo que devuelve: es todo lo que necesita para empezar.