C3 docs

Appearance

Autenticación y token de acceso ​

Para interactuar con la API de C3, todas las solicitudes deben ser autenticadas. Esto se logra mediante un token de acceso, una clave única que garantiza que solo los usuarios autorizados puedan consumir los recursos de la API.

Generación del token de acceso ​

Para obtener su token, siga estos pasos:

  1. Inicie sesión en C3 con un usuario que tenga el rol de Coordinador.
  2. Navegue al panel de configuración.
  3. Genere un nuevo token de acceso.

Este token debe ser incluido en cada solicitud HTTP dentro del encabezado Authorization utilizando el esquema Bearer.

ℹ Vigencia del Token

El token generado no tiene fecha de expiración. Permanecerá activo de forma indefinida hasta que decida regenerarlo manualmente.

Regeneración del token ​

Puede invalidar un token existente y generar uno nuevo en cualquier momento. Este proceso es útil si el token ha sido expuesto, extraviado o si desea reforzar la seguridad.

Para regenerar el token, acceda a la opción correspondiente en el panel de configuración.

🛑 Acción irreversible

Al generar un nuevo token, el anterior quedará inhabilitado de forma permanente. Asegúrese de actualizar todas sus integraciones y sistemas con el nuevo token para evitar interrupciones en el servicio.

URL base de la API ​

Todas las rutas de la API deben construirse a partir de la URL base que se le proporcionó durante la implementación de su instancia de C3. Este dominio es único para su entorno.

Formato de la URL base: ​

bash
https://<su-dominio>.c3.pe

Asegúrese de reemplazar <su-dominio> con el nombre de su instancia. Por ejemplo: https://gip.c3.pe.

Requisitos adicionales para API de WhatsApp ​

Para utilizar los endpoints específicos de la API de WhatsApp, es indispensable que tenga al menos una cuenta de WhatsApp configurada y activa dentro de la plataforma C3. Este requisito asegura que los mensajes se envíen desde un número autorizado y correctamente vinculado.

Resumen de puntos clave ​

  • Autenticación: Todas las solicitudes a la API requieren un token de acceso en el encabezado Authorization.
  • Vigencia: El token no expira, pero puede ser regenerado en cualquier momento.
  • Regeneración: Al crear un nuevo token, el anterior se invalida permanentemente.
  • URL Base: Utilice siempre el dominio asignado a su instancia para construir las URLs de los endpoints.
  • Requisito de WhatsApp: Es obligatorio tener una cuenta de WhatsApp configurada en la plataforma C3 para el uso del API.