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

📥 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

Crea un cliente ApiRest con manejo de cookies.
Construye los datos del comentario:
- content
- parent (publicación)
- parenttype = Publicaciones
- parentfield = comments
Envía un POST al endpoint del ERP:

{APICAPACITACION}/resource/postComend2
Maneja error HTTP (BadResponseException).
Si la respuesta contiene data, devuelve éxito.
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..."
}'

Revisión #1
Creado 2025-11-24 18:21:31 -05 por Elian
Actualizado 2025-11-24 18:24:52 -05 por Elian