Cars

Car

Request Information
URL GEThttps://api.inventario.pro/public/v2/coche?apiKey={{apiKey}}&photo_damage_ad_id={{adId}}
Category Cars
Description

This endpoint makes an HTTP GET request to retrieve damage photos of a specific car ad using the provided API key and ad ID.

Request

  • apiKey (query parameter, required) - The API key for authentication.

  • photo_damage_ad_id (query parameter, required) - The ID of the car ad from which to retrieve damage photos.

Response

The response will be in JSON format and will contain various details of the damage photos.

Each damage photo includes a danyos object with coordinates indicating the approximate location of the damage on the template:

  • position_x: The horizontal position of the damage, expressed as a relative value between 0 (left edge) and 1 (right edge) of the image.
  • position_y: The vertical position of the damage, expressed as a relative value between 0 (top edge) and 1 (bottom edge) of the image.

These values represent percentages and can be used to overlay damage markers on the template, starting from the top-left corner as the origin (0,0).

Damage Template

The coordinates refer to the location of the damage on the vehicle image template shown below.

Vehicle damage template
Header
APP-KEY {{appkey}}

Example responses

Car
Response Code:
200OK
Response Body:
[
    {
        "nombre": "b6e41471-f602-47e7-a6b9-df93a379c8cc",
        "orden": "0",
        "urls": {
            "original": "https://fotos.inventario.pro/coche/1/334739/b6e41471-f602-47e7-a6b9-df93a379c8cc_original.jpg",
            "large": "https://fotos.inventario.pro/coche/1/334739/b6e41471-f602-47e7-a6b9-df93a379c8cc_large.jpg",
            "medium": "https://fotos.inventario.pro/coche/1/334739/b6e41471-f602-47e7-a6b9-df93a379c8cc_medium.jpg",
            "400px": "https://fotos.inventario.pro/coche/1/334739/b6e41471-f602-47e7-a6b9-df93a379c8cc_400px.jpg",
            "small": "https://fotos.inventario.pro/coche/1/334739/b6e41471-f602-47e7-a6b9-df93a379c8cc_small.jpg"
        },
        "danyos": {
            "position_x": "0.5159",
            "position_y": "0.2955",
            "ad_photo_damage_type_id": "1",
            "damage_type": "Desgaste"
        }
    },
    {
        "nombre": "66b08aed-f2c6-484a-80b5-046ff9a49fac",
        "orden": "1",
        "urls": {
            "original": "https://fotos.inventario.pro/coche/1/334739/66b08aed-f2c6-484a-80b5-046ff9a49fac_original.jpg",
            "large": "https://fotos.inventario.pro/coche/1/334739/66b08aed-f2c6-484a-80b5-046ff9a49fac_large.jpg",
            "medium": "https://fotos.inventario.pro/coche/1/334739/66b08aed-f2c6-484a-80b5-046ff9a49fac_medium.jpg",
            "400px": "https://fotos.inventario.pro/coche/1/334739/66b08aed-f2c6-484a-80b5-046ff9a49fac_400px.jpg",
            "small": "https://fotos.inventario.pro/coche/1/334739/66b08aed-f2c6-484a-80b5-046ff9a49fac_small.jpg"
        },
        "danyos": {
            "position_x": "0.2412",
            "position_y": "0.1955",
            "ad_photo_damage_type_id": "6",
            "damage_type": "Golpe"
        }
    }
]