> For the complete documentation index, see [llms.txt](https://academy.gopersonal.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.gopersonal.ai/developers/plataforma-ecommerce/vtex/api-credentials-setup-guide-for-gopersonal-integration.md).

# Credenciales de API: Guía de configuración para la integración con gopersonal

gopersonal utiliza la API del Catalog System de VTEX para sincronizar productos. Esta guía te acompaña en el proceso de crear las credenciales de API con los permisos correctos y verificar que tengas el rol requerido.

### Requisitos previos

* **Rol requerido**: necesitás tener el rol **Catalog** en tu cuenta de VTEX para acceder a la API del Catalog System.

### Endpoint de la API

El endpoint utilizado para la sincronización de productos es:

```
${url}/api/catalog_system/pub/products/search
```

### Creación de las credenciales de API

Seguí estos pasos para crear y configurar tus credenciales de API:

1. **Acceder al admin de VTEX**
   * Iniciá sesión en tu cuenta de VTEX
   * Navegá al panel de administración de tu tienda
2. **Generar la API Key**
   * Andá a: Configuración de la cuenta > Accesos y permisos > Acceso a API
   * Hacé clic en "Generar nueva clave"
   * Asigná un nombre a la clave (por ejemplo, "Gopersonal Catalog API Access")
   * Hacé clic en "Crear clave"
3. **Configurar los permisos de la API**
   * En la ventana de creación de la clave, buscá la sección "Permisos"
   * En "Recursos", seleccioná "Catalog"
   * En "Tipos de acceso", elegí "Read"
   * Hacé clic en "Agregar permiso"
4. **Guardar las credenciales**
   * Copiá el AppKey y el AppToken que se muestran
   * Almacená estas credenciales de forma segura
   * Hacé clic en "Cerrar" para finalizar

### Notas importantes de seguridad

* Tratá el AppKey y el AppToken con el mismo cuidado que una contraseña
* El AppToken no se puede volver a visualizar después de su creación inicial
* Asegurate de contar con las medidas de seguridad adecuadas para almacenar y utilizar estas credenciales

Siguiendo esta guía vas a tener las credenciales de API necesarias para integrar gopersonal con tu catálogo de VTEX. Si encontrás algún inconveniente o necesitás asistencia adicional, contactá al soporte de VTEX o a tu account manager.