Autenticación - Uso básico

El primer paso para empezar a interactuar con nuestra API es generar un token con el podrás hacer las distintas llamadas. Una vez creado el Token, debes ver en la documentación del recurso con el cual quieres interactuar cuales son los parametros a enviar, la URL y el verbo ( GET, PUT, POST, DELETE)

Para crear el token de usuario debes ingresar en tu cuenta como vendedor e ir a la opción “Integraciones” que se encuentra en el menu desplegable que se abre cuando presionas sobre tu nombre (arriba a la derecha). Una vez ahi podrás crear el token que te servira para todas tus llamadas.

Tambien los administradores puede crear sus token desde el panel de admistración

La URL base para las llamadas es https://__URL_DE_TU_MARKET__/api/v1/. Por ejemplo si la url de tu market fuese ingenio-market.loc la URL base para las llamadas api sería: https://ingenio-market.loc/api/v1/

Ejemplo de llamada a la API

Para armar cada URL se indica el path del recurso. Cada recurso está disponible con un método (GET; POST etc) determinado.

Headers a enviar en cada request

Debes incluir en el header el token:

Authorization: Bearer 1|gcuLz11M0LapVax1kKsyi6T0RVOgJX4UXro0pSEf

Además del header de autenticación es importante indicar el tipo de contenido aceptado para las respuestas en todos los requests:

Accept: application/json

Adicionalmente, en requests de tipo POST y PUT se debe incluir un header que indique el Content-Type.

Content-Type: application/json

Ejemplo de una llamada GET

curl --location --request GET 'http://ingenio-market.loc/api/v1/categories/' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer 1|gcuLz11M0LapVax1kKsyi6T0RVOgJX4UXro0pSEf'

Aclaracion: La API puede recibir hasta 60 peticiones por minuto, superada esa cantidad de llamadas retornara un error.

/