Saltar al contenido principal

Crea tu primera solicitud a la API de Proset

En este tutorial, crearemos una clave de API de desarrollador y la usaremos para hacer una solicitud a la API de Proset. Al terminar, habremos confirmado que la API puede leer los datos de nuestra propia cuenta.

Usaremos la línea de comandos, pero los mismos pasos funcionan con cualquier herramienta que pueda enviar una solicitud HTTP.

Antes de empezar​

Asegúrate de que:

  • iniciaste sesión en Proset;
  • tienes la app abierta, en un dispositivo o en el navegador; y
  • puedes abrir una terminal u otra herramienta para enviar solicitudes.

La API para desarrolladores está disponible para cualquier usuario con sesión iniciada, sin costo adicional.

Abre los ajustes de desarrollador​

  1. Abre Ajustes.
  2. Abre Desarrollador.

La pantalla muestra dos direcciones a las que puedes conectarte:

  • API REST — la dirección para hacer solicitudes directas;
  • Servidor MCP — la dirección para conectar un asistente de IA.

Crea una clave de API​

  1. Selecciona Crear clave.
  2. Elige una caducidad. El valor predeterminado es 90 días.
  3. Selecciona Crear.

Proset muestra la clave completa una sola vez. Cópiala ahora y guárdala en un lugar seguro. Proset solo guarda un hash unidireccional, así que no puede volver a mostrarla.

Haz tu primera solicitud​

Abre una terminal y ejecuta:

curl https://proset.ai/api/v1/me \
  -H "Authorization: Bearer TU_CLAVE"

Reemplaza TU_CLAVE por la clave que copiaste.

La respuesta es un JSON corto que describe tu cuenta, tu plan y tu uso actual. Si ves tus propios datos, la solicitud funcionó.

Confirma el resultado​

La respuesta demuestra tres cosas:

  1. La clave es válida.
  2. La solicitud llegó a Proset.
  3. La API devolvió datos solo de tu propia cuenta.

Si en su lugar la respuesta muestra invalid_api_key o expired_api_key, crea una nueva clave e inténtalo de nuevo.

Ve más allá​

Completaste el camino principal. Ahora puedes:

Para entender cuándo elegir la API REST o el servidor MCP, lee Por qué usar la API para desarrolladores y el servidor MCP.