#
Conectar con la API
La API REST de Biteral es el principal método de conexión de vuestro sistema a Biteral, y es el método recomendado para integraciones de cualquier tamaño flexibles y fiables.
Si utilizas PHP, es muy recomendable utilizar el SDK de Biteral para PHP, que proporciona un interfaz extremadamente sencillo y fiable para trabajar con la API de Biteral.
#
Antes de empezar
La API key de pruebas os permite utilizar Biteral gratuitamente, ideal para realizar pruebas desde vuestro entorno de desarrollo y ver resultados reales sobre cómo funcionaría Biteral con vuestro sistema. Sin embargo, la API key de pruebas tiene algunos límites:
Límite de peticiones por segundo estricto
Algunos endpoints tienen el máximo de peticiones por segundo limitado, así que es posible que obtengas un código de respuesta 429 Too Many Requests al utilizar una API key de pruebas y realizar demasiadas peticiones en un breve espacio de tiempo.
Límite máximo de peticiones diarias
Algunos endpoints sólo pueden recibir cierto número de peticiones por día. Al utilizar una API key de pruebas, si alcanzas este límite obtendrás también un código de respuesta 429 Too Many Requests
#
Cómo conectar
Realiza peticiones HTTPS a https://api.biteral.net incluyendo los siguientes headers:
- X-API-Key Vuestra API key
- X-API-Version La versión principal de la API que vas a utilizar, por ejemplo: 1
curl \
-G https://api.biteral.net/status \
-H 'X-API-Key: ux3HzRTaLGKvZjTb7ufaFUgJPvXbcNX7DWbnWAAUxQjHYqZJ' \
-H 'X-API-Version: 1'use Biteral\Client;
$client = new Client('ux3HzRTaLGKvZjTb7ufaFUgJPvXbcNX7DWbnWAAUxQjHYqZJ');
$status = $client->getInfo();
print_r($status);
#
Enviar y recibir datos en la API
Los endpoints
POST
,
PUT
y
PATCH
normalmente aceptan los datos en formato JSON a través del body de la petición. Por ejemplo, éste es el cuerpo de una petición
POST
al endpoint
/products
para enviar un producto a Biteral:
{
"code": "N30123",
"title": "Zapatillas deportivas urbanas para hombre – modelo AirFlow",
"description": "Estas zapatillas combinan estilo y comodidad para el uso diario. Diseñadas con materiales transpirables, suela de goma antideslizante y plantilla ergonómica, son ideales tanto para caminar por la ciudad como para entrenar en interiores. El modelo AirFlow ofrece un ajuste perfecto y un diseño moderno que se adapta a cualquier look casual. Disponibles en varias tallas y colores."
}Otros endpoints del tipo GET o DELETE aceptan datos a través de los parámetros en la URL de la petición. Por ejemplo, ésta es la URL para una petición GET al endpoint /products que obtiene los datos de un producto:
https://api.biteral.net/products?code=B00YUU43VSTodos los endpoints responden siempre en formato JSON, por ejemplo:
{
"object": "product",
"id": "pro_Fm3NC30gQHfxIP",
"createdAt": "2025-07-09T10:21:11+00:00",
"updatedAt": "2025-07-09T10:42:48+00:00",
"payload": {
"code": "N30122",
"isActive": true,
"title": "Zapatillas deportivas urbanas para hombre – modelo AirFlow",
"description": "Estas zapatillas combinan estilo y comodidad para el uso diario. Diseñadas con materiales transpirables, suela de goma antideslizante y plantilla ergonómica, son ideales tanto para caminar por la ciudad como para entrenar en interiores. El modelo AirFlow ofrece un ajuste perfecto y un diseño moderno que se adapta a cualquier look casual. Disponibles en varias tallas y colores.",
"attributes": null,
"brand": null,
"category": null,
"price": {
"amount": "49.95",
"currency": "EUR"
}
}
}
#
Códigos de respuesta
Los códigos HTTP de respuesta indican si la petición se realizó con éxito, o si se produjo algún error: