Guías
Give Feedback

Introduction

Updated on September 22, 2021

ūüĎčūüŹĽ ¬°Bienvenido a la gu√≠a de integraci√≥n de Handy!

Si no eres desarrollador o no tienes idea de qué es una API y solo deseas iniciar sesión en tu cuenta de Handy, puedes hacerlo aquí

Esto es lo primero que debes leer.

En esta guía, te mostramos cómo iniciar con nuestra API para integrar tu sistema administrativo o ERP.

La API es REST, utiliza el formato de datos JSON y est√° protegida con HTTPS y un Bearer Token.


1. Crea una cuenta gratuita en Handy

Puedes hacerlo aquí.

No necesitas una tarjeta de crédito. Obtendrás el producto completo durante 14 días.

En caso de que necesites más tiempo para efectos de una integración, escríbenos en el chat.

2. Crea un token de API.

Ve a editar tu usuario y presione el botón verde para crear tu token de API personal.

3. Prueba tu token.

Esta prueba requiere que tengas instalado cURL en tu terminal

Abre una ventana de terminal y ejecute esto:

curl -H "Authorization: Bearer API_TOKEN" https://app.handy.la/api/v2/user

Deberías obtener una respuesta como esta:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "pagination": {
        "totalCount": 50,
        "totalPages": 5,
        "currentPage": "https://app.handy.la/api/v2/user?page=1",
        "nextPage": "https://app.handy.la/api/v2/user?page=2",
        "prevPage": null,
        "firstPage": "https://app.handy.la/api/v2/user?page=1",
        "lastPage": "https://app.handy.la/api/v2/user?page=5"
    },
    "users": [
        {
            "id": 1153,
            "username": "enrique@gmail.com",
            ...
        }
    ]
}

ūü•≥ ¬°Eso es todo! acabas de recibir una lista de tus usuarios en formato JSON a trav√©s de la API ūü•≥


Algunos detalles importantes

Estas son algunas otras consideraciones técnicas importantes con respecto a la API que encontrarás en la referencia completa:

  • Hay l√≠mites de uso (rate limit) que debes tener en cuenta, especialmente si haces llamadas en paralelo. El l√≠mite es relativamente alto, por lo que solo incurrir√°s en √©l si hay un patr√≥n de abuso. El l√≠mite es de 500 solicitudes por minuto.
  • Utiliza el formato dd/MM/aaaa HH:mm:ss para las fechas. No olvides codificarlo si es un par√°metro de consulta de URL. La zona horaria que se tomar√° ser√° la del usuario al que corresponde el token de API.
  • Los resultados est√°n paginados. Est√°s en la √ļltima p√°gina cuando nextPage es nulo.
  • Las llamadas API tienen un tiempo de espera m√°ximo de 30 segundos.

Puedes continuar explorando en el artículo sobre cómo integrar los pedidos a tu ERP o sistema administrativo, que ahí te mostramos cómo manejar estos detalles.