Funciones de la API de la Tienda

Con estas funciones de la API, puedes gestionar el inventario y los pedidos de tu tienda de mascotas.

Obtener inventarios de mascotas

Devuelve los inventarios de mascotas por estado.

Punto final: https://petstore3.swagger.io/api/v3/store/inventory

Operación: GET

Ejemplos

Clave API

GET "https://petstore3.swagger.io/api/v3/store/inventory" \
-H "accept: application/json" \
-H "api_key: <TU_CLAVE_API>"

OAuth 2.0

GET "https://petstore3.swagger.io/api/v3/store/inventory" \
-H "accept: application/json" \
-H "Authorization: Bearer <TU_TOKEN_OAUTH>"

Respuestas

Código	Descripción
200	Operación exitosa
default	Error inesperado

Ejemplo de respuesta

200: Operación exitosa

{
  "sold": 0,
  "available": 0,
  "pending": 0
}

Parámetros

Ninguno

Realizar un pedido

Realiza un pedido para una mascota.

Punto final: https://petstore3.swagger.io/api/v3/store/order

Operación: POST

Ejemplos

Clave API

POST "https://petstore3.swagger.io/api/v3/store/order" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "api_key: <TU_CLAVE_API>" \
-d '{ 
  "id": 0,
  "petId": 0,
  "quantity": 0,
  "shipDate": "2025-08-11T15:13:06.939Z",
  "status": "placed",
  "complete": false
}'

OAuth 2.0

POST "https://petstore3.swagger.io/api/v3/store/order" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <TU_TOKEN_OAUTH>" \
-d '{ 
  "id": 0,
  "petId": 0,
  "quantity": 0,
  "shipDate": "2025-08-11T15:13:06.939Z",
  "status": "placed",
  "complete": false
}'

Respuestas

Código	Descripción
200	Operación exitosa
400	Pedido inválido
default	Error inesperado

Ejemplo de respuesta

200: Operación exitosa

{
  "id": 0,
  "petId": 0,
  "quantity": 0,
  "shipDate": "2025-08-11T15:13:06.939Z",
  "status": "placed",
  "complete": false
}

Parámetros

Cuerpo de la solicitud

Nombre	Tipo	Descripción
body	Objeto pedido	(Obligatorio) El objeto Order para la mascota.

Encontrar un pedido

Encuentra un pedido por su ID.

Punto final: https://petstore3.swagger.io/api/v3/store/order/{orderId}

Operación: GET

Ejemplos

Clave API

GET "https://petstore3.swagger.io/api/v3/store/order/1" \
-H "accept: application/json" \
-H "api_key: <TU_CLAVE_API>"

OAuth 2.0

GET "https://petstore3.swagger.io/api/v3/store/order/1" \
-H "accept: application/json" \
-H "Authorization: Bearer <TU_TOKEN_OAUTH>"

Respuestas

Código	Descripción
200	Operación exitosa
400	ID inválido suministrado
404	Pedido no encontrado
default	Error inesperado

Ejemplo de respuesta

200: Operación exitosa

{
  "id": 1,
  "petId": 0,
  "quantity": 0,
  "shipDate": "2025-08-11T15:13:06.939Z",
  "status": "placed",
  "complete": false
}

Parámetros

Parámetros de ruta

Nombre	Tipo	Descripción
orderId	integer	ID de la orden de compra para recuperar

Eliminar un pedido

Elimina un pedido por su ID.

Punto final: https://petstore3.swagger.io/api/v3/store/order/{orderId}

Operación: DELETE

Ejemplos

Clave API

DELETE "https://petstore3.swagger.io/api/v3/store/order/1" \
-H "accept: application/json" \
-H "api_key: <TU_CLAVE_API>"

OAuth 2.0

DELETE "https://petstore3.swagger.io/api/v3/store/order/1" \
-H "accept: application/json" \
-H "Authorization: Bearer <TU_TOKEN_OAUTH>"

Respuestas

Código	Descripción
200	pedido eliminado
400	ID inválido suministrado
404	Pedido no encontrado
default	Error inesperado

(Una eliminación exitosa devuelve un código 200 sin cuerpo de respuesta.)

Parámetros

Parámetros de ruta

Nombre	Tipo	Descripción
orderId	integer	ID del pedido a eliminar