Consultar credenciales
Usuario y contraseña de la empresa, para integraciones que obtienen el token iniciando sesión.
Autenticación: token Bearer de cuenta (empresas:manage).
Consideraciones
- Para integraciones que obtienen el token con
POST /api/auth/cpe/token(login con usuario/contraseña) en vez de usar el token directo. - Las credenciales se generan al crear la empresa; este endpoint las recupera cuando las necesites.
Headers
| Name | Type | Description |
|---|---|---|
| Accept | string | application/json |
| Content-Type | string | application/json |
| Authorization | string | Bearer <token>. Genéralo desde tu panel, en Tokens de API. |
Parámetros de URL
| Name | Type | Description |
|---|---|---|
| ruc* | string | RUC de 11 dígitos de la empresa. |
Ejemplo de solicitud
Copiar
curl -X GET https://api.xmlperu.dev/v1/companies/20123456789/credentials \
-H "Authorization: Bearer $TOKEN_CUENTA" \
-H "Accept: application/json"Copiar
<?php
$token_cuenta = 'pega-aqui-tu-token';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.xmlperu.dev/v1/companies/20123456789/credentials');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $token_cuenta,
'Accept: application/json',
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);Copiar
const TOKEN_CUENTA = 'pega-aqui-tu-token';
const res = await fetch('https://api.xmlperu.dev/v1/companies/20123456789/credentials', {
method: 'GET',
headers: {
Authorization: `Bearer ${TOKEN_CUENTA}`,
Accept: 'application/json',
},
});
const data = await res.json();Copiar
import requests
TOKEN_CUENTA = "pega-aqui-tu-token"
headers = {
"Authorization": f"Bearer {TOKEN_CUENTA}",
"Accept": "application/json",
}
res = requests.get("https://api.xmlperu.dev/v1/companies/20123456789/credentials", headers=headers)
data = res.json()Respuesta
200 Credencialesapplication/json
{
"success": true,
"message": "Credenciales de la empresa.",
"data": {
"credentials": {
"username": "a1b2c3d4",
"password": "e5f6g7h8",
"login": "POST /api/auth/cpe/token"
}
}
}404 No encontradaapplication/json
{
"success": false,
"message": "Empresa no encontrada."
}