Saltar al contenido principal
Llama a un endpoint conocido desde tu backend mediante la HTTP API. No se requiere ningún Agent.

​
Llamar a un endpoint

Ejemplo: toma un nombre de usuario de Instagram de tu aplicación y recupera sus publicaciones públicas más recientes.
1

Conecta tu backend

URL base: https://api.glasser.ai
Encabezado: Authorization: Bearer <your Key>Cuenta de tu producto: usa la Key de tu Workspace.
Cuenta de tu usuario: selecciona la Key de ese usuario para cada solicitud.Guarda las Keys en tu backend. Comprueba la conexión con una solicitud gratuita a GET /v1/balance.
2

Inspecciona el Endpoint una vez durante la configuración

Envía JSON a POST /v1/endpoints/inspect:
Obtén: el esquema de entrada y el Price actual. Este endpoint requiere username, un array que contenga un nombre de usuario. La inspección es gratuita.
3

Llámalo desde tu producto

Envía JSON a POST /v1/runs. Usa el mismo encabezado Authorization, Content-Type: application/json, y un encabezado Idempotency-Key único para esta ejecución prevista.
Sustituye mkbhd por la entrada de tu usuario.Obtén: un Run con id, status y charge_usd. Cuando esté listo, output contendrá hasta 10 publicaciones públicas con textos, cantidades de Me gusta y cantidades de comentarios.Para QUEUED o RUNNING, lee ese Run hasta que alcance un estado terminal. Los Runs usan el saldo del Workspace conectado.
  • Establece endpoint_version a partir de Inspect, o no lo incluyas para usar la versión predeterminada. Una versión no fija el Price; los nuevos Runs usan el Price vigente al admitirse.
  • Reintenta la misma solicitud con el mismo Idempotency-Key y la misma entrada. Sigue leyendo un Run sin terminar en lugar de crear otro.
  • Comprueba status y provider_response.http_status antes de usar output. Un Run COMPLETED todavía puede contener un error del proveedor de datos.
  • Guarda el ID del Run y charge_usd junto con el registro de solicitud de tu producto. Un Run fallido todavía puede generar un cargo según el Price del endpoint.
  • Mantén separada la Key de cada usuario. Selecciónala desde su conexión autenticada, no desde los campos de entrada de la solicitud.

​
Explorar las API de proveedores de datos

Elige un endpoint en Data Sources y, después, inspecciónalo para consultar su esquema. Puedes reutilizarlo sin buscarlo antes de cada Run. Para enumerar proveedores de datos y endpoints en el código, usa GET /public/catalog. No se requiere ninguna Key y la solicitud es gratuita:
  • providers: nombres y descripciones de los proveedores de datos, y cantidades de endpoints.
  • entries: identificadores, descripciones, categorías y precios mostrados de los endpoints. Relaciona provider para encontrar los endpoints de un proveedor de datos.
  • Una respuesta: la lista pública completa, sin paginación.
La respuesta se almacena en caché y no aplica la Policy de tu Key. Usa Inspect con tu Key para consultar el esquema de entrada y el Price actual del endpoint seleccionado antes de ejecutarlo.

​
Opcional: Solutions

La GTM Solution ofrece seis capacidades fijas mediante HTTP. Glasser gestiona la selección del endpoint, la asignación de entradas y el fallback para los fallos compatibles. Cada Capability tiene su propia API en /v1/solutions/gtm/. Usa la misma Key y un encabezado Idempotency-Key; la respuesta es un Run. Consulta Descripción general de Solutions para ver un ejemplo y las reglas de selección del proveedor de datos.