Saltar a contenido

REST API - Cómo empezar

1. Crear una cuenta

Si no tienes una cuenta de teenvio, lo primero que debes hacer es crear una de forma gratuita.

2. Crear un Token

Crea un nuevo usuario para el api y genera un token. Es importante configurar la seguridad y permisos: para usuarios de api es necesario asignar el permiso "api"

Create Token

3. Lanza tu primer test

Ahora ya puedes lanzar una primera petición, por ejemplo, obtener la versión actual del API:

1
2
3
4
5
export TE_TOKEN='Your token'

curl -X GET https://app.teenvio.com/v4/public/api/rest/v3/version/ \
-H "X-Token: $TE_TOKEN" \
-H "Accept: application/json"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
<?php

$token = 'Your token';

$url_base = 'https://app.teenvio.com/v4/public/api/rest/v3'

$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_URL => $url_base.'/version/',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => array(
        'Accept: application/json',
        'X-Token: '.$token
    ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
import requests

token = 'Your token'

url_base = 'https://app.teenvio.com/v4/public/api/rest/v3'

my_headers = {
    'Accept' : 'application/json',
    'X-Token' : token
}

response = requests.get(url_base+"/version/", headers=my_headers)

print(response.json())

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
const axios= require('axios');

const token = 'Your token';

const url_base = 'https://app.teenvio.com/v4/public/api/rest/v3';

const my_headers = {
    'Accept' : 'application/json',
    'X-Token' : token
};

axios.get(url_base+'/version', {headers:my_headers}).then( resp => {
        console.log(resp.data);
});

Respuesta: 

{
  "action": "get_version",
  "time": "2022-10-20 15:00:09",
  "status": "OK",
  "response": "v3.0-202206",
  "code": 0
}