API Reference

Obtener listado de Herramientas

Este endpoint obtiene el listado de herramientas de su empresa en CMMShere

HTTP Request

GET https://admin.cmmshere.com/api/v1/tools

Parámetros de consulta

Estos parámetros son opcionales y utilizados para filtrar e interactuar con la información obtenida. Los parámetros de filtrado (si se utilizan) se usan para buscar resultados que contengan dicho texto.

ParámetroTipoDefaultDescripción
codStringNo definidoSi se utiliza, el resultado solo incluirá herramientas que contengan ese código
nameStringNo definidoSi se utiliza, el resultado solo incluirá herramientas que contengan ese nombre
descriptionStringNo definidoSi se utiliza, el resultado solo incluirá herramientas que contengan ese texto en la descripción
categoryIntNo definidoSi se utiliza, el resultado solo incluirá herramientas de esa categoría especifica (basado en el ID de categoría)
offsetIntNo definidoOffset para paginación
limitIntNo definidoLímite para paginación
orderByArray["created_at", "desc"]Ordenamiento. El primer valor es el campo y el segundo la dirección ASC o DESC

Ejemplo de petición

curl --location --request GET 'https://admin.cmmshere.com/api/v1/tools' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 804|fCkDcz43egLAubMzPinRCIVUIjPUsGkvbVJ864IP' \
--header 'Cookie: XSRF-TOKEN=eyJpdiI6IktwckY2VTNIOU5UYVZvUjg5eUxXV2c9PSIsInZhbHVlIjoiOTlpVEZIVGRnZEJoRnN3RnpVK3lLMjZZQnBHVGFrc2VNZU5XVUplamswTjl1RC8yVk1JY0lUWGVSVDlIN0YxZnEzQldLQjRyUUFmTEQ2WWFhbDNDNXVVSTZ2QVg2aEkxTTNaZWI3NzlvZVJGV3dmRlFXUU5qVWhhelFCOFpRaTgiLCJtYWMiOiIwMzU2Y2YyNTk5YjE2ZmYyN2Y4MmJkMzQyNjg4MTU2MGJjZjY1MWZjYTAxMDdjNjlkYTkxYjIzZTkwZjZlMmZhIn0%3D; laravel_session=eyJpdiI6IkpMOHR1c3pYOHpXem9vZmhUa0RqUXc9PSIsInZhbHVlIjoiWGY3RGlUV3A3WGJyQ3JvZ29nWVdYWFRtbFA5U0VmU3RLdmVuMVZQcEMwa3B4VGlYb1M2SG5TYTA5U1hxclJNT2tyRDdoanhqWVFITHB3SEdENzZzaTl5RlBZR3hOc2VJNGQzczVxZDdTNC9pMVRobXBTckM4emlzTWtNNjFGS1kiLCJtYWMiOiIyZGZkODQ2YjI2YmU0NGUyYmU0YTAwNTBiNDk3ODU2MTMwMjEyOGUyOGE0YzIzOTMzZjAxZGQzMGY0MGVkOGU1In0%3D' \
--data '{
    "offset" : 0,
    "limit" : 5,
    "orderBy" : ["cod", "desc"]
}'

La petición de arriba devuelve un JSON estructurado de la siguiente manera

{
    "success": true,
    "code": 200,
    "results": [
        {
            "id": 274,
            "cod": "P0000100",
            "creator_id": 30,
            "category": 15,
            "name": "herramienta modificada 1",
            "quantity": 5,
            "status": "0",
            "description": "descripcion modificada 1",
            "created_at": "2023-09-11T20:46:51.000000Z"
        },
        {
            "id": 260,
            "cod": "P0000099",
            "creator_id": 35,
            "category": 15,
            "name": "Medidor de resistencia de tierra Kyoritsu",
            "quantity": 1,
            "status": "1",
            "description": "Medidor de resistencia de aislamiento de tierra",
            "created_at": "2023-02-28T20:41:57.000000Z"
        },
        {
            "id": 259,
            "cod": "P0000098",
            "creator_id": 35,
            "category": 15,
            "name": "Taladro inalámbrico Gladiador",
            "quantity": 1,
            "status": "1",
            "description": "Taladro inalámbrico Gladiador",
            "created_at": "2023-02-28T20:21:26.000000Z"
        },
        {
            "id": 258,
            "cod": "P0000097",
            "creator_id": 35,
            "category": 15,
            "name": "Fasimetro",
            "quantity": 2,
            "status": "1",
            "description": "Rotador de fases",
            "created_at": "2023-02-28T20:19:35.000000Z"
        },
        {
            "id": 257,
            "cod": "P0000096",
            "creator_id": 35,
            "category": 15,
            "name": "Caladora Stanley",
            "quantity": 1,
            "status": "1",
            "description": "Caladora Stanley",
            "created_at": "2023-02-28T20:14:23.000000Z"
        }
    ]
}