get-services
Este método obtiene el listado de servicios que el usuario tiene creados en la plataforma (se utiliza paginación para la consulta ordenada).
Notas
Si necesitas más información sobre cómo funciona la paginación consulta la sección: Paginación
Path del método
get-services
Endpoint final
PRODUCCION
https://aceptabits.com/api/thirdparty/v1/get-services
SANDBOX DE PRUEBAS
https://sandbox.aceptabits.com/api/thirdparty/v1/get-services
Método de petición HTTP
GET
Lista de parámetros
| Parámetro | Obligatorio | Descripción | valor |
|---|---|---|---|
| page | Si | Es la pagina que se utilizara en la paginación de la petición | Ejemplo: 1, 2, 3, etc. Este valor debe ser numérico y entero, indicara la página actual a la cual se hará la consulta |
| limit | Si | Es el límite de elementos que se utilizara en la paginación de la petición | Ejemplo: 5, 10, 20, 50, etc. Este valor debe de ser numérico y entero, con un valor máximo posible de 100, si se envía un número mayor a 100 se realizara la consulta con el valor 100 |
| order_list | Si | Es el orden de listado para mostrar la información utilizando la fecha de creación como referencia | Se aceptan dos valores el 1 y el 2: 1 = ordenara los resultados por fecha de creación de manera ascendente 2 = ordenara los resultados por fecha de creación de manera descendente |
| code_shop | No | Es el código de la tienda a la que se requiere obtener el listado de servicios en especifico | ejemplo: pgbsho0635214789653205 Este código es único de cada tienda, se obtiene al consultar el listado de tiendas o al generar una tienda nueva, consulte los métodos: get-shops, add-shop o show-shop para más detalles |
| search | No | Se utiliza como filtro de búsqueda para la consulta de los servicios, el filtro se aplicara dentro de:name code code_shop name_shopPara más información de estos campos consulta el metodo add-service, show-service o en esta misma sección en Ejemplo de respuesta EXITOSA | Ejemplo: pgbser9653365214, pgbsho6199, asesoría, mano de obra, curso profesional, etc. Se puede enviar una cadena de texto, un numero o cualquier valor que se quiera utilizar como filtro |
Lista de códigos
Exitoso
| Código | Descripción |
|---|---|
| 0045 | Lista de servicios obtenida con éxito |
Error
| Código | Descripción |
|---|---|
| 0000 | El Token API no es correcto y la autenticación del usuario ha fallado |
| 0003 | El Token API no es correcto y la autenticación del usuario ha fallado |
| 1220 | El Token API no es correcto y la autenticación del usuario ha fallado |
| 1348 | El orden de listado es requerido |
| 1349 | El orden de listado debe de contener un valor valido para el orden ascendente o descendente |
| 1577 | El campo página de la paginación es requerido |
| 1578 | El campo límite de la paginación es requerido |
| 1221 | El Token API no es correcto y la autenticación del usuario ha fallado |
| 1222 | Ocurrió un problema al obtener el listado de servicios, inténtelo nuevamente o consulte con soporte técnico para más ayuda |
Ejemplo de respuesta EXITOSA
Exitoso
Código HTTP 200
{
"status": true,
"success": {
"code": "0045"
},
"data": {
"current_page": 1,
"data": [
{
"code": "pgbser43252313631985235",
"name": "Venta general",
"price_mxn": "0.00000000",
"code_shop": "pgbsho44747793463129176",
"name_shop": "Velas martin",
"created_at": "2024-08-06T21:40:57.000000Z",
"created_at_format": "2024-08-06 16:40:57",
"isEditable": "0"
},
{
"code": "pgbser52217131614198414",
"name": "Curso de fabricación de velas",
"price_mxn": "0.00000000",
"code_shop": "pgbsho44747793463129176",
"name_shop": "Velas martin",
"created_at": "2024-08-08T01:30:43.000000Z",
"created_at_format": "2024-08-07 20:30:43",
"isEditable": "-1"
},
{
"code": "pgbser56683545785157568",
"name": "Decoracion 10 mesas para boda",
"price_mxn": "12000.00000000",
"code_shop": "pgbsho44747793463129176",
"name_shop": "Velas martin",
"created_at": "2024-08-08T01:53:40.000000Z",
"created_at_format": "2024-08-07 20:53:40",
"isEditable": "-1"
}
],
"from": 1,
"last_page": 1,
"per_page": 10,
"to": 3,
"total": 3
}
}
Descripcion de la respuesta
- Revisar el listado de
códigos EXITOSOpara conocer el significado desuccesscode. data- Se obtiene la información de los servicios y la información actual de la paginacióncurrent_page- Indica cual es la página actual en la paginaciónlast_page- Indica cual es el último número de página posible (este valor cambia dependiendo del límite de elementos por página que se envió con el parámetro limit)per_page- Indica el límite de elementos mostrados por paginafrom- indica el índice inicial de la numeración de los servicios mostrado en esta paginato- indica el índice final de la numeración de los servicios mostrado en esta paginatotal- Indica el número de total de elementos que existendata- Arreglo donde se listan los servicios que tiene creados el usuario en la plataformacode- Código del servicio (este código es único para cada servicio dado de alta)name- Nombre del servicioprice_mxn- Precio en MXN (Peso mexicano) del serviciocode_shop- Código de la tienda a la que pertenece el servicioname_shop- Nombre de la tienda a la que pertenece el serviciocreated_at- Fecha y hora de creación del servicio (UTC)created_at_format- Fecha y hora de creación del servicio (America/Mexico_City)isEditable- indica si el servicio se puede o no editar, los valores posibles son:- 0 = no se puede editar
- -1 = si se puede editar
Ejemplo de respuesta FALLIDA
Error
Código HTTP 400, Código HTTP 401, Código HTTP 500
{
"status": false,
"error": {
"code": "1348"
}
}
Descripción de la respuesta
- Revisar el listado de
códigos ERRORpara conocer la causa y saber cómo corregir - Si se obtiene un código HTTP
500comunicarse a soporte técnico - Si se obtiene un código HTTP
401revisar que el Token API este correcto
Notas
Si tienes alguna duda recuerda que siempre puedes contactar con el equipo de soporte para desarrolladores ingresando en el siguiente enlace: Soporte para desarrolladores.