Child pages
  • Parámetros Webservice

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Parámetros Webservice

In this page, you can enable your shop's webservice, so that third-party tools can access your data. This potentially makes it possible for interesting tools to help you or your customers make better use of your shop (such as mobile applicationsEn esta página, puedes activar el webservice (servicio web) de tu tienda, para que herramientas de terceros puedan acceder a tus datos. Potencialmente, esto abre la puerta a la creación de herramientas útiles que ayudarán a tus clientes o a ti mismo a utilizar tu tienda de manera más eficaz (como por ejemplo, aplicaciones móviles).

Info

A web service is a method of communication between two electronic devices over a network. It relies on a known set of methods, formats and access rights, so as be able to use the webservice's content on any other authorized tool, and build upon the original content. Read more about it on Un webservice (servicio web) es un método de comunicación entre dos dispositivos a través de una red. Estos se basan en un conjunto conocido de métodos, formatos y permisos de acceso, que se utilizan para acceder al contenido del servicio web desde cualquier herramienta autorizada, y obtener o intercambiar datos. Puedes leer más sobre este método de comunicación en la siguiente página de la Wikipedia: http://enes.wikipedia.org/wiki/WebServicio_service.

The page starts by listing the currently existing webservice keys in a table, if there is any. A webservice key is a unique access that you grant to a developer, which can be used to tie a tool to your shop. Share them sparingly, as you might not always want everyone to access your data.

Image Removed

Not any app can access your shop through the PrestaShop webservice: you decide which can, and what they are allowed to do. Every app has a unique connection key, with specific access rights.

Adding a new key

The "Add new" button takes you to the webservice key creation form:

  • Key. A unique key. You can either create your own, or choose to use a generated one, for instance by clicking the "Generate" button or by using any online key generator. Generated keys are most of the time safer, because they are harder to guess.
  • Key description. A reminder of who that key is for, and what it gives access to.
  • Status. You can disable a key anytime. This enables you to only temporarily grant access to your data from a certain key.
  • Permissions. You do not have to share ALL your data with each key. You can choose among a wide array of permissions, either by section or by type of access. You might want some applications to only be able to view a handful of items, while some others (for instance, ones that you would use to manage the shop remotely) should be able to edit and delete just about everything. Choose wisely.

Image Removed

Configuration

Warning

For security reasons, make sure your shop's server supports secure SSL connection!

The configuration is pretty easy:

  • Enable PrestaShop's webservice. If you do not want anyone to access your shop through third-party tools and applications, just keep it disabled.
  • Enable CGI mode for PHP. The CGI mode is a special setting for the Apache server, where you tell it to use PHP as a CGI script rather than an Apache module. While the CGI mode has a reputation of being more secure, it has been found to have a security flaw as recently as May 2012. Ask your web host for advices.

Image Removed

Note

Developers can find our documentation on how to build a tool around PrestaShop's webservice at this addressweb.

Al abrir la página se lista las claves del servicio web existentes en una tabla. Una clave de servicio web es un acceso único que tu proporcionas al desarrollador, la cual puede ser utilizada para vincularla con la herramienta de tu tienda. Comparte estas claves con moderación, de no hacerlo así muchas personas podrían tener acceso a tus datos.

Image Added

No todas las aplicaciones pueden acceder a tu tienda a través del servicio web de PrestaShop: tu decides cuales pueden hacerlo, y determinar lo que cada una de ellas puede realizar. Cada aplicación tiene una clave de conexión única, con derechos de acceso específicos.

Añadir una nueva clave

El botón "Añadir nuevo" te redirecciona al formulario de creación de claves del servicio web:

  • Clave. Una clave única. Puedes crear una tu mismo, u optar por utilizar una generada, haciendo clic en el botón "¡Generar!" o bien utilizar cualquier generador de claves en línea. Las claves generadas son más seguras, porque son más difíciles de adivinar.
  • Descripción de la clave. Un recordatorio del destinatario de la clave, y los derechos que le proporcionas.
  • Estado. Puedes desactivar una clave en cualquier momento. Esto te permite conceder sólo temporalmente el acceso a tus datos a una determinada clave.
  • Permisos. No debes compartir TODOS tus datos con cada clave. Puedes elegir entre una amplia gama de permisos, ya sea por sección o por tipo de acceso. Es posible que desees que algunas aplicaciones sólo sean capaces de visualizar algunos de tus artículos, mientras que otras (por ejemplo, la que utilizarías para gestionar la tienda de forma remota) podrían tener permisos para modificar y eliminar casi todos los datos. Te recomendamos que realices esta selección de permisos con cuidado.

Image Added

Configuración

Warning

¡Por razones de seguridad, asegúrate de que el servidor de tu tienda acepta conexiones SSL!.

La configuración es muy sencilla:

  • Activar el servicio Web de PrestaShop. Si no quieres que nadie tenga acceso a tu tienda a través de herramientas y aplicaciones de terceros, manten esta opción desactivada.
  • Activar el modo CGI para PHP. El modo CGI es una configuración especial del servidor Apache con el que se especifica que se utilice PHP en modo CGI en lugar de como un módulo de Apache. Si bien el modo CGI tiene una reputación de ser más seguro, se han encontrado fallos de seguridad en mayo de 2012. Consulta esta configuración con tu proveedor de hosting.Image Added
Note

Los desarrolladores encontrarán más información para crear aplicaciones, y herramientas que utilizan el webservice de PrestaShop en esta dirección: http://doc.prestashop.com/display/PS16/Using+the+PrestaShop+Web+Service.