1. API del recurso Fabricante

A cotinuación se brinda la información necesaria para la manipulación del recurso Fabricante

1.1. ¿Cómo publicar un nuevo Fabricante?

1.1.1. Petición curl

$ curl 'http://localhost:8080/fabricante' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{
  "id" : null,
  "nombre" : "Emp. Guru",
  "direccionId" : null,
  "direccion" : {
    "id" : null,
    "calle" : "Peralta",
    "numeroEstablecimiento" : 3,
    "entreCalles" : "Costa y Lorem",
    "municipio" : "Mayari",
    "estado" : "Holguín",
    "pais" : "Cuba",
    "zip" : 106
  },
  "productos" : null
}'

1.1.2. Petición http

POST /fabricante HTTP/1.1
Content-Type: application/json
Content-Length: 331
Host: localhost:8080

{
  "id" : null,
  "nombre" : "Emp. Guru",
  "direccionId" : null,
  "direccion" : {
    "id" : null,
    "calle" : "Peralta",
    "numeroEstablecimiento" : 3,
    "entreCalles" : "Costa y Lorem",
    "municipio" : "Mayari",
    "estado" : "Holguín",
    "pais" : "Cuba",
    "zip" : 106
  },
  "productos" : null
}

1.1.3. Ejemplo de la respuesta http

{
  "id" : "5f6d630c6218360b01b65cbb",
  "nombre" : "Emp. Guru",
  "direccionId" : "5f6d630c6218360b01b65cba",
  "productos" : null
}

1.1.4. Petición httpie

$ echo '{
  "id" : null,
  "nombre" : "Emp. Guru",
  "direccionId" : null,
  "direccion" : {
    "id" : null,
    "calle" : "Peralta",
    "numeroEstablecimiento" : 3,
    "entreCalles" : "Costa y Lorem",
    "municipio" : "Mayari",
    "estado" : "Holguín",
    "pais" : "Cuba",
    "zip" : 106
  },
  "productos" : null
}' | http POST 'http://localhost:8080/fabricante' \
    'Content-Type:application/json'

1.1.5. Cuerpo de la petición

{
  "id" : null,
  "nombre" : "Emp. Guru",
  "direccionId" : null,
  "direccion" : {
    "id" : null,
    "calle" : "Peralta",
    "numeroEstablecimiento" : 3,
    "entreCalles" : "Costa y Lorem",
    "municipio" : "Mayari",
    "estado" : "Holguín",
    "pais" : "Cuba",
    "zip" : 106
  },
  "productos" : null
}

1.1.6. Ejemplo del cuerpo de la respuesta

{
  "id" : "5f6d630c6218360b01b65cbb",
  "nombre" : "Emp. Guru",
  "direccionId" : "5f6d630c6218360b01b65cba",
  "productos" : null
}

1.1.7. Campos del cuerpo de la petición

Path Type Description

id

String

El id del fabricante

nombre

String

El nombre del fabricante

direccionId

String

El id de la dirección del fabricante

productos

Array

Un arreglo de productos hechos por el fabricante

productos[]

Array

Un arreglo de productos hechos por el fabricante

productos[].id

String

El id de un producto hecho por el fabricante

productos[].nombre

String

El nombre de un producto hecho por el fabricante

productos[].fabricanteId

String

El id del fabricante del producto

productos[].categorias[]

Array

Un arreglo de categorias a las que pertenece el producto

productos[].categorias[].id

String

El id de la categoría a la cual pertenece el producto

productos[].categorias[].nombre

String

El nombre de la categoría a la cual pertenece el producto

direccion.id

String

Id de la dirección del fabricante

direccion.calle

String

Calle donde reside el fabricante

direccion.numeroEstablecimiento

Number

Número del establecimiento donde reside el fabricante

direccion.entreCalles

String

Las dos primeras calles que interceptan perpendicularmente la calle principal del establecimiento del fabricante

direccion.municipio

String

Municipio donde reside el fabricante

direccion.estado

String

Estado donde reside el fabricante

direccion.pais

String

País donde reside el fabricante

direccion.zip

Number

Código postal de la zona donde reside el fabricante

1.1.8. Campos del cuerpo de la respuesta

Path Type Description

id

String

El id del fabricante

nombre

String

El nombre del fabricante

direccionId

String

El id de la dirección del fabricante

productos

Array

Un arreglo de productos hechos por el fabricante

1.2. ¿Cómo obtener todos los Fabricantes?

1.2.1. Petición curl

$ curl 'http://localhost:8080/fabricante' -i -X GET

1.2.2. Petición http

GET /fabricante HTTP/1.1
Host: localhost:8080

1.2.3. Ejemplo de la respuesta http

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 386

[ {
  "id" : "5f6d344cf3f5774afb51efed",
  "nombre" : "Empresa Lorem Ipsum",
  "direccionId" : "5f6d344cf3f5774afb51efec",
  "productos" : [ {
    "id" : "5f6d3496f3f5774afb51efef",
    "nombre" : "mouse",
    "categorias" : [ {
      "id" : "5f6d345df3f5774afb51efee",
      "nombre" : "Computer hardware"
    } ],
    "fabricanteId" : "5f6d344cf3f5774afb51efed"
  } ]
} ]

1.2.4. Petición httpie

$ http GET 'http://localhost:8080/fabricante'

1.2.5. Cuerpo de la petición

No tiene cuerpo de petición

1.2.6. Ejemplo del cuerpo de la respuesta

[ {
  "id" : "5f6d344cf3f5774afb51efed",
  "nombre" : "Empresa Lorem Ipsum",
  "direccionId" : "5f6d344cf3f5774afb51efec",
  "productos" : [ {
    "id" : "5f6d3496f3f5774afb51efef",
    "nombre" : "mouse",
    "categorias" : [ {
      "id" : "5f6d345df3f5774afb51efee",
      "nombre" : "Computer hardware"
    } ],
    "fabricanteId" : "5f6d344cf3f5774afb51efed"
  } ]
} ]

1.2.7. Campos del cuerpo de la respuesta

Path Type Description

[]

Array

Un arreglo de fabricantes

[].id

String

El id del fabricante

[].nombre

String

El nombre del fabricante

[].direccionId

String

El id de la dirección del fabricante

[].productos

Array

Un arreglo de productos hechos por el fabricante

[].productos[]

Array

Un arreglo de productos hechos por el fabricante

[].productos[].id

String

El id de un producto hecho por el fabricante

[].productos[].nombre

String

El nombre de un producto hecho por el fabricante

[].productos[].fabricanteId

String

El id del fabricante del producto

[].productos[].categorias[]

Array

Un arreglo de categorias a las que pertenece el producto

[].productos[].categorias[].id

String

El id de la categoría a la cual pertenece el producto

[].productos[].categorias[].nombre

String

El nombre de la categoría a la cual pertenece el producto