Ir al contenido principal

Enviar Comentarios Post (1) - [sendComment]

🧾 Descripción

Registra un nuevo comentario dentro de una publicación del módulo de ā€œPublicacionesā€ en ERP/Capacitación.

El servicio envía la información del comentario a un endpoint del ERP mediante autenticación por cookie.


šŸš€ Endpoint


POST /send-comment

La ruta real depende del archivo de rutas Laravel (api.php).


šŸ” Seguridad


Cookie: session_id=...

šŸ“„ Request Body

{ "content": "string", "parent": "string", "cookie": "string" }

Descripción de campos

Campo Tipo Requerido Descripción
content string SĆ­ Texto del comentario.
parent string SĆ­ ID del documento Publicaciones al que pertenece el comentario.
cookie string Sí Cookie de sesión vÔlida del ERP.

Otros campos se envĆ­an de forma fija al backend:

{ "parenttype": "Publicaciones", "parentfield": "comments" }

šŸ“¤ Responses

āœ”ļø 200 – Comentario creado correctamente

{ "valor": true, "msn": "Creado correctamente", "data": { ... } }

āŒ 400 – Error en datos del cliente

El servicio no valida explĆ­citamente los campos, pero si backend rechaza:

{ "valor": "false", "msn": "Error de servidor", "data": "Detalle del error del ERP" }

āŒ 500 – Error al procesar la solicitud

Cuando la API del ERP responde con error:

{ "valor": "false", "msn": "Error de servidor", "data": "<mensaje de error>" }

🧩 Lógica interna del servicio

  1. Crea un cliente ApiRest con manejo de cookies.

  2. Construye los datos del comentario:

    • content

    • parent (publicación)

    • parenttype = Publicaciones

    • parentfield = comments

  3. EnvĆ­a un POST al endpoint del ERP:


    {APICAPACITACION}/resource/postComend2
  4. Maneja error HTTP (BadResponseException).

  5. Si la respuesta contiene data, devuelve Ʃxito.

  6. Si no, marca error de creación.


šŸ—ƒ Schemas

Request Schema

{ "content": "string", "parent": "string", "cookie": "string" }

Response Schema

{ "valor": "boolean|string", "msn": "string", "data": "object" }

🧪 Ejemplo de uso (curl)

curl -X POST https://midominio.com/api/send-comment \ -H "Content-Type: application/json" \ -d '{ "content":"Excelente publicación", "parent":"PUB-00045", "cookie":"sid=cd2312fa..." }'