Agregar o quitar monedas a un conductor

[ POST ]

Esta ruta permite agregar o quitar monedas a un conductor.

https://sync.airbagtech.io/coins/modify

Headers

Content-Type	Autorization
application/json	apikey {{API_KEY}}

Body

Se debe enviar un objeto JSON (body) con los siguientes atributos:

{
  "driverId": "string",
  "value": "number",
  "description": "string"
}

Campos

Nombre	Tipo	Requerido	Descripción
driverId	string	Sí	Id del conductor
value	number	Sí	Cantidad de monedas a agregar o quitar
description	string	Sí	Descripción de la modificación

Valores de los datos

Nombre	Descripción
value	Debe ser un número entero Puede ser número positivo eg. 20 (para agregar monedas) Puede ser número negativo eg. -20 (para quitar monedas) El valor no debe sobre pasar +/- 2000

Ejemplo

curl --location --request POST 'https://sync.airbagtech.io/coins/modify' \
--header 'Content-Type: application/json' \
--header 'Authorization: apikey {{API_KEY}}' \
--data '{
    "driverId": "5f7b3b3b1c9d4400008d3b3b",
    "value": 20,
    "description": "Agregando monedas"
}'

Respuesta

201 - Created

{
    "status": true,
    "transactionId": "xJcvkFGYXVqP22qlSYj5",
    "oldCoins": 10,
    "newCoins": 30
}

Campos

Nombre	Descripción
transactionId	Id de la transacción
oldCoins	Cantidad de monedas antes de la modificación
newCoins	Cantidad de monedas después de la modificación
status	Estado de la petición

401 - Unauthorized

{
    "status": false,
    "message": "mensaje de error"
}

400 - Bad Request

{
    "status": false,
    "message": "mensaje de error"
}

campos

Nombre	Descripción
message	Mensaje de error
status	Estado de la petición