Documentación API pública V1 — Trowel Developers

POST/api/public/v1/snag-points/{id}/photos

snag-points:write

Parámetros

iduuidobligatorioruta

Repaso.

Respuesta

201Fotos añadidas.

PublicSnagPointPhoto

Foto de repaso

Metadatos de una foto asociada a un estado.

PropiedadTipoDescripción

idobligatoriouuidIdentificador.

snagPointIdobligatoriouuidRepaso.

stateHistoryIdobligatoriouuidEstado asociado.

stateobligatoriostringEstado.

fileNameobligatoriostringNombre.

contentTypeobligatoriostringMIME.

fileSizeobligatoriointegerBytes.

createdAtobligatoriodate-timeFecha.

Ejemplo JSON

{
  "id": "54fe2c8f-0831-4487-b65c-22661e4505d9",
  "snagPointId": "cbefdbb8-acde-49f9-8cc5-390024315c2b",
  "stateHistoryId": "ac1edabe-babf-4099-9ce6-2253fc817def",
  "state": "pending",
  "fileName": "humedad.jpg",
  "contentType": "image/jpeg",
  "fileSize": 245120,
  "createdAt": "2026-10-10T12:00:00"
}

Ejemplo de respuesta

{
  "id": "54fe2c8f-0831-4487-b65c-22661e4505d9",
  "snagPointId": "cbefdbb8-acde-49f9-8cc5-390024315c2b",
  "stateHistoryId": "ac1edabe-babf-4099-9ce6-2253fc817def",
  "state": "pending",
  "fileName": "humedad.jpg",
  "contentType": "image/jpeg",
  "fileSize": 245120,
  "createdAt": "2026-10-10T12:00:00"
}

Errores

400Solicitud incorrectaapplication/json

401Autenticación inválida o no proporcionadaapplication/json

403Permisos insuficientesapplication/json

404Recurso no encontradoapplication/json

409Conflicto con el estado actualapplication/json

410Recurso ya no disponibleapplication/json

422Error de validaciónapplication/json

429Límite de solicitudes excedidoapplication/json

Ver modelo de error

PublicApiError

Error de API

Formato estable de los errores públicos.

PropiedadTipoDescripción

statusobligatoriointegerCódigo HTTP.

codeobligatoriostringCódigo estable para tratamiento automático.

messageobligatoriostringMensaje legible.

correlationIdobligatoriostringIdentificador para soporte y trazabilidad.

currentConcurrencyTokenstring | nullToken actual cuando existe un conflicto.

validationErrorsobject<string,string[]>Errores agrupados por campo.

Ejemplo JSON

{
  "status": 422,
  "code": "validation_error",
  "message": "The request is invalid.",
  "correlationId": "01J9EXAMPLE",
  "validationErrors": {
    "unitCode": [
      "The unit does not exist."
    ]
  }
}