Información de Perfil del Usuario

GET

/me

Con esta interfaz, puede consultar el saldo de su cuenta. Si utiliza una obtendrá el saldo disponible (sin IVA). Si tiene una cuenta de pospago, obtendrá su límite de crédito de sms restante. La respuesta a la consulta también contiene información sobre tus servicios SMS disponibles y tus grupos.

Authorizations

token

Responses

200

Client resource

Info about your user’s account

object

@id

JSON-LD ID

string

@type

JSON-LD type

string

@context

One of:

string
object

string

ID del usuario actual

integer

>= 1

currency

Moneda

string

default: EUR

Allowed values: EUR CHF

balance_changed_at

Marca de tiempo cuando se cambió el saldo

integer

is_text_deleted

Parámetro global para eliminar textos de mensajes después del envío

boolean

balance_amount

Cantidad del saldo

number

services

Lista de los códigos de servicios disponibles

Array<string>

Allowed values: economy pro text2speech text2speech_ssml direct

groups

Objeto con IDs de grupo como claves y sus URIs de endpoint correspondientes como valores

object

key

additional properties

string

/^/groups/[0-9]+$/

Example

{
  "@context": {
    "hydra": "http://www.w3.org/ns/hydra/core#"
  },
  "currency": "EUR",
  "services": [
    "economy"
  ],
  "groups": {
    "24512": "/groups/24512",
    "24513": "/groups/24513",
    "24519": "/groups/24519"
  }
}

Info about your user’s account

object

ID del usuario actual

integer

>= 1

currency

Moneda

string

default: EUR

Allowed values: EUR CHF

balance_changed_at

Marca de tiempo cuando se cambió el saldo

integer

is_text_deleted

Parámetro global para eliminar textos de mensajes después del envío

boolean

balance_amount

Cantidad del saldo

number

services

Lista de los códigos de servicios disponibles

Array<string>

Allowed values: economy pro text2speech text2speech_ssml direct

groups

Objeto con IDs de grupo como claves y sus URIs de endpoint correspondientes como valores

object

key

additional properties

string

/^/groups/[0-9]+$/

Example

{
  "currency": "EUR",
  "services": [
    "economy"
  ],
  "groups": {
    "24512": "/groups/24512",
    "24513": "/groups/24513",
    "24519": "/groups/24519"
  }
}

401

El ID de cliente o la clave API no están activos o no son válidos.

403

La cuenta no está activada. Espere o póngase en contacto con el servicio de asistencia.

429

La dirección IP fue bloqueada temporalmente, ya que durante poco tiempo se enviaron muchas solicitudes con credenciales no válidas. Espere y pruebe más tarde.

Code Samples

#!/usr/bin/env bash
curl -X GET https://api.lox24.eu/me \
  -H 'X-LOX24-AUTH-TOKEN: 1234567:e3f3a759b6677959b6ebfcxxxxxxxxxx'

using Newtonsoft.Json.Linq;
using System;
using System.IO;
using System.Net;
using System.Text;

namespace Lox24.Api
{
    class client
    {
        static void Main()
        {
            string key = "1234567:e3f3a759b6677959b6ebfcxxxxxxxxxx";
            string url = "https://api.lox24.eu/me";

            var httpWebRequest = (HttpWebRequest)WebRequest.Create(url);
            httpWebRequest.ReadWriteTimeout = 100000;
            httpWebRequest.Accept = "application/json"; // or application/ld+json
            httpWebRequest.Method = "GET";
            //httpWebRequest.KeepAlive = true;
            httpWebRequest.Headers.Add("X-LOX24-AUTH-TOKEN", key);
            httpWebRequest.Credentials = CredentialCache.DefaultNetworkCredentials;

            try
            {
                using (HttpWebResponse resp = (HttpWebResponse)httpWebRequest.GetResponse())
                {
                    int respCode = (int)resp.StatusCode;
                    Console.WriteLine("Success:{0} {1}", respCode, "client resource response");

                    Stream respStream = resp.GetResponseStream();
                    using (StreamReader sr = new StreamReader(respStream, Encoding.UTF8))
                    {
                        string responseText = sr.ReadToEnd();
                        Console.WriteLine("responseText : {0}", responseText);
                    }
                }

            }
            catch (System.Net.WebException ex)
            {
                var webResponse = ex.Response as System.Net.HttpWebResponse;
                Console.WriteLine("Error:{0}", webResponse.StatusCode);

                //int errorCode = int.Parse(Regex.Replace(ex.Message, @"\D", ""));
                switch (webResponse.StatusCode)
                {

                    case HttpStatusCode.Unauthorized: // 401
                        Console.WriteLine("Error:401 Client ID or API key isn't active or invalid!");
                        break;
                    case HttpStatusCode.Forbidden: // 403
                        Console.WriteLine("Error:403 Account isn't activated. Please wait or contact to support!");
                        break;
                    case HttpStatusCode.InternalServerError: // 500
                    case HttpStatusCode.BadGateway: //502
                    case HttpStatusCode.ServiceUnavailable: // 503
                    case HttpStatusCode.GatewayTimeout: // 504
                        Console.WriteLine("System error! Please contact to LOX24 support!");
                        break;
                }
            }
        }
    }

package main

import (
  "fmt"
  "io/ioutil"
  "log"
  "net/http"
)

func main() {

  const Method = "GET"
  const URL = "https://api.lox24.eu/me"
  const Token = "1234567:1234567:e3f3a759b6677959b6ebfcxxxxxxxxxx"

  client := &http.Client{}

  req, err := http.NewRequest(Method, URL, nil)
  if err != nil {
    log.Fatal(err)
  }

  req.Header.Add("X-LOX24-AUTH-TOKEN", Token)
  req.Header.Add("Accept", "application/json")

  res, err := client.Do(req)
  if err != nil {
    log.Fatal(err)
  }

  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    log.Fatal(err)
  }

  switch res.StatusCode {
  case 200:
    fmt.Println((string(body)))
  case 401:
    fmt.Println("Error: code = 401 - Client ID or API key isn't active or invalid!")
  case 403:
    fmt.Println("Error: code = 403 - Account isn't activated. Please wait or contact to support!")
  default:
    fmt.Printf("Error: code = %d\n", res.StatusCode)
  }
}

package eu.lox24.doc.user;

import java.io.IOException;
import java.net.HttpURLConnection;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class GetAccountInfo {

    public static void main(String[] args) {

        var key = "1234567:e3f3a759b6677959b6ebfcxxxxxxxxxx";
        var url = "https://api.lox24.eu/me";

        var httpRequest = HttpRequest.newBuilder(URI.create(url))
                .timeout(Duration.ofMillis(100000))
                .setHeader("Accept", "application/json")
                .setHeader("X-LOX24-AUTH-TOKEN", key)
                .GET()
                .build();

        var client = HttpClient.newBuilder().build();

        try {
            var httpResponse = client.send(httpRequest, HttpResponse.BodyHandlers.ofString());

            if (httpResponse.statusCode() == HttpURLConnection.HTTP_OK) {
                System.out.println("Success:" + httpResponse.statusCode() + " " + "client resource response");
                System.out.println("Response text : \n" + httpResponse.body());

            } else {

                System.out.println("Error:" + httpResponse.statusCode());

                switch (httpResponse.statusCode()) {

                    case HttpURLConnection.HTTP_UNAUTHORIZED: // 401
                        System.out.println("Error:401 Client ID or API key isn't active or invalid!");
                        break;
                    case HttpURLConnection.HTTP_FORBIDDEN: // 403
                        System.out.println("Error:403 Account isn't activated. Please wait or contact to support!");
                        break;
                    case HttpURLConnection.HTTP_INTERNAL_ERROR: // 500
                    case HttpURLConnection.HTTP_BAD_GATEWAY: //502
                    case HttpURLConnection.HTTP_UNAVAILABLE: // 503
                    case HttpURLConnection.HTTP_GATEWAY_TIMEOUT: // 504
                        System.out.println("System error! Please contact to LOX24 support!");
                        break;
                }

            }

        } catch (IOException | InterruptedException e) {
            e.printStackTrace();
        }
    }
}

const host = 'api.lox24.eu';
const token = "1234567:e3f3a759b6677959b6ebfcxxxxxxxxxx";

const https = require('https');
const options = {
    hostname: host,
    path: '/me',
    method: 'GET',
    headers: {
        'Accept': 'application/json',
        'Content-Type': 'application/json',
        'X-LOX24-AUTH-TOKEN': token
    }
}

const req = https.request(options, res => {
    if (res.statusCode == 200) {
        console.log('Success: code = 200 - client resource response');
        res.on('data', d => {
            process.stdout.write(d)
        })
    } else {
        console.log(`statusCode: ${res.statusCode}`)
        if (res.statusCode == 200) {
            console.log("Success: code = 200 - bulks collection response");
        } else if (res.statusCode  == 401) {
            console.log("Error: code = 401 - Client ID or API key isn't active or invalid!");
        } else if (res.statusCode  == 403) {
            console.log("Error: code = 403 - Account isn't activated. Please wait or contact to support!");
        }  else {
            console.log("Error: code = " + res.statusCode );
        }
    }
});

req.on('error', error => {
    console.error(error)
});

req.end();

<?php

$uri = 'https://api.lox24.eu/me';
$token = '1234567:e3f3a759b6677959b6ebfcxxxxxxxxxx';


$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => $uri,
    CURLOPT_HTTPHEADER => [
        "X-LOX24-AUTH-TOKEN: {$token}",
        'Accept: application/json', // or application/ld+json
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
]);

$response = curl_exec($curl);
$code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

$data = json_decode($response, JSON_OBJECT_AS_ARRAY);

if(200 === $code) {
    echo 'Success: response data = ' . var_export($data, true);
} else {
    echo "Error: code = {$code}, data = " . var_export($data, true);
}

import json
import requests


token = "1234567:e3f3a759b6677959b6ebfcxxxxxxxxxx"

token = "4f8432430c640ee96c9f8a3eb880d477"
client_id = "3"

url = 'https://api.lox24.eu/me'


headers = {
    'Accept': 'application/json',
    'X-LOX24-AUTH-TOKEN': token,
}

try:
    # timeout is 100 seconds
    res = requests.get(url, headers=headers, timeout=100)
    if res.status_code != 200:
        res.raise_for_status()
    else:
        print('Success: code = 200 - client resource response')
        print("Response: ", json.dumps(res.json(), indent=4))

except requests.HTTPError:
    if res.status_code == 401:
        print("Error: code = 401 - Client ID or API key isn't active or invalid!")
    elif res.status_code == 403:
        print("Error: code = 403 - Account isn't activated. Please wait or contact to support!")
    elif res.status_code in (500, 502, 503, 504):
        print("System error! Please contact to LOX24 support!")
    else:
        print(f"Error: code {res.status_code}")
    print(json.dumps(res.json(), indent=4))