Autenticación

La API de búsqueda de Suede se autentica con una clave de API bearer. Cada petición debe llevar tu clave en la cabecera Authorization.

Crear una clave

Crea y gestiona claves en tu cuenta de Suede en Ajustes → Integración → Claves de API:

1. Introduce un nombre para la clave, de modo que puedas reconocerla más adelante.
2. Haz clic en Crear. La clave completa se muestra una sola vez: cópiala de inmediato y guárdala en un lugar seguro.
3. A partir de entonces solo se muestra una forma enmascarada (suede_live_abc123…wxyz). Suede nunca almacena la clave en bruto, así que no puede recuperarse de nuevo. Si pierdes una clave, revócala y crea una nueva.

Revoca una clave en cualquier momento desde la misma pantalla; una clave revocada deja de funcionar de inmediato.

Formato de la clave

Una clave tiene este aspecto:

suede_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Empieza con el prefijo suede_live_, seguido de un secreto aleatorio. Trata una clave como una contraseña: cualquiera que la posea puede buscar a costa del crédito de tu cuenta. Mantenla en el servidor; nunca la incrustes en código del lado del cliente, aplicaciones móviles o repositorios públicos.

La cabecera Authorization

Envía la clave como token bearer en cada petición:

Authorization: Bearer suede_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Hacer una petición autenticada

curl "https://api.suede.io/v1/search?q=hello+world" \
  -H "Authorization: Bearer $SUEDE_API_KEY"

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new("Bearer", Environment.GetEnvironmentVariable("SUEDE_API_KEY"));
var json = await http.GetStringAsync("https://api.suede.io/v1/search?q=hello+world");
Console.WriteLine(json);

const res = await fetch("https://api.suede.io/v1/search?q=hello+world", {
  headers: { Authorization: `Bearer ${process.env.SUEDE_API_KEY}` },
});
console.log(await res.json());

Ámbitos

Una clave creada en los ajustes de tu cuenta lleva el ámbito search, que concede acceso a todos los endpoints de búsqueda v1 y a Uso. Una petición hecha con una clave que carece del ámbito requerido se rechaza con HTTP 403 y type: insufficient_scope; consulta Errores.

Autenticación fallida

Una clave ausente, mal formada, inválida o revocada devuelve HTTP 401:

{ "error": { "type": "unauthorized", "message": "Provide a valid API key as a Bearer token.", "request_id": "…" } }

Próximos pasos

• Usa la URL base (api.suede.io).
• Empieza por Búsqueda web.
• Gestiona los errores y los límites de frecuencia.