Secreto

Endpoint protegido de prueba que valida la autenticación.

Descripción

Este endpoint requiere un token de autenticación válido. Se utiliza para verificar que la capa de autenticación funciona correctamente.

Autenticación

Requiere autenticación glueauth.Require mediante una clave API o sesión válida.

Solicitud

No se requiere cuerpo en la solicitud.

Ejemplo

curl -X GET "https://api.hola.cloud/v0/secret" \
  -H "Authorization: Bearer <api-key>"
GET /v0/secret HTTP/1.1
Host: api.hola.cloud
Authorization: Bearer <api-key>
// Go 1.21+, standard library only. Save as main.go and run: go run main.go
package main

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

func main() {
	req, err := http.NewRequest("GET", "https://api.hola.cloud/v0/secret", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer <api-key>")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	responseBody, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status)
	fmt.Println(string(responseBody))
}
<?php
// PHP 8+ with the curl extension. Save as example.php and run: php example.php

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.hola.cloud/v0/secret',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer <api-key>',
    ],
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new Exception(curl_error($ch));
}
echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), "\n", $response, "\n";
curl_close($ch);
# Python 3.8+. Install: pip install requests. Save as example.py and run: python example.py
import requests

headers = {
    "Authorization": "Bearer <api-key>",
}

response = requests.request(
    "GET",
    "https://api.hola.cloud/v0/secret",
    headers=headers
)

print(response.status_code)
print(response.text)
// Node.js 18+. Save as example.mjs and run: node example.mjs
const response = await fetch("https://api.hola.cloud/v0/secret", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <api-key>"
  }
});

console.log(response.status);
console.log(await response.text());
const response = await fetch("https://api.hola.cloud/v0/secret", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <api-key>"
  }
});

console.log(response.status);
console.log(await response.text());
// Java 17+, standard library only. Save as Main.java and run: java Main.java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.hola.cloud/v0/secret"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .header("Authorization", "Bearer <api-key>")
            .build();

        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Respuesta

1OK

Códigos de Error

Código Descripción
200 Autenticación exitosa
401 Autenticación faltante o inválida

Comentarios

Deja un comentario