Para tu asistente de IA

bipbip-context — llm

bipbip context --for llm

Construir con IA

Pegá el contexto completo de la Merchant API de BipBip en tu asistente de IA — Claude, Cursor o Copilot — para que integre más rápido y deje de inventar endpoints. Todo sigue la convención llms.txt, un estándar abierto que empaqueta la documentación en texto plano listo para un LLM.

curl -s https://developer-portal.bipbip.dev/llms-full.txt

Dos archivos que cubren toda la integración de una sola vez. El índice curado para navegar, o el bundle completo para pegar directo en un prompt.

# primeras líneas de la salida

# BipBip Merchant API

> Integration API for merchants: an inbound REST API to manage orders and
> outbound HMAC-signed webhooks that deliver order and menu events to your POS.

Base URLs: https://merchant-api.bipbip.hn (production)
Payload schema version: 1.0
Abrir

curl -s https://developer-portal.bipbip.dev/llms.txt

El índice llms.txt: una lista curada de todos los temas con enlaces a cada archivo. Ideal como punto de entrada.

Abrir

ls llms/

# elegí un archivo o copiá su enlace

  • quickstart.txt

    Quickstart — Overview of both API surfaces, base URLs, required REST headers, and the end-to-end happy path.

    Abrir

  • rest-api.txt

    REST API — Inbound REST endpoints (Orders + menu), idempotency, rate limits, and the RFC 7807 error envelope.

    Abrir

  • webhooks.txt

    Webhooks — Transport contract, HMAC verification, signed headers, auth strategies, retries, and every event type.

    Abrir

  • schemas.txt

    Schemas — Field-by-field JSON payload schemas for orders, status updates, and menu-change results.

    Abrir

  • changelog.txt

    Changelog — Dated contract changes classified as breaking, behavior, or additive, each with the action it requires. Read this before assuming a field, status, or filter still behaves the way an older integration expects.

    Abrir

cat prompts/*

Copiá uno de estos prompts, reemplazá el marcador de contexto por el archivo correspondiente y dáselo a tu asistente.

Receptor de webhooks con verificación HMAC

Este es el contexto de la Merchant API de BipBip: <pegá aquí llms-full.txt>. Escribí un receptor de webhooks en Node.js con Express que capture el raw body, verifique la firma HMAC-SHA256 del header X-Bipbip-Signature-256 en tiempo constante y maneje el evento order.created respondiendo 200 con el remoteOrderId.

Cliente REST para aceptar órdenes

Usando este contexto de la REST API de BipBip: <pegá aquí rest-api.txt>. Generá una función en Python que acepte una orden llamando POST /api/v1/Orders/{orderKey}/accept con los headers X-Bipbip-Api-Key e Idempotency-Key, y que reintente con backoff exponencial ante un 429.

Tipos a partir de los schemas

Con estos schemas de payload de BipBip: <pegá aquí schemas.txt>. Generá interfaces de TypeScript para el payload de order.created y para el envelope OrderUpdateEvent, marcando bien los campos opcionales.