Referencia de la API

Cada operación de la API HTTP de Emporium, generada del contrato: qué hace, cómo se llama y por dónde se llega.

Las operaciones

84 operaciones, en el orden del contrato. Cada una lleva a su página de referencia.

  1. GET /

    get_front_page

    La portada en inglés: HTML para personas, con el lema, For developers (/developers), For agents (/llms.txt), Privacy y el selector EN | ES; con Accept: text/markdown, el cuerpo de /index.md

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  2. GET /.well-known/agent-card.json

    get_agent_card

    La tarjeta A2A: habla MCP, no A2A

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  3. GET /.well-known/agent-skills/emporium-business-diagnosis/SKILL.md

    get_business_diagnosis_skill

    La skill de diagnostico de un negocio: medirlo, matchearlo contra la oferta, el camino mas corto y la demanda

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  4. GET /.well-known/agent-skills/index.json

    get_agent_skills_index

    El indice de skills: /skill.md con su sha256

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  5. GET /.well-known/agent.json

    get_agent_json

    La tarjeta A2A en su lugar viejo

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  6. GET /.well-known/api-catalog

    get_api_catalog

    El catalogo de APIs, RFC 9727

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  7. GET /.well-known/mcp/server-card.json

    get_mcp_server_card

    La tarjeta del servidor MCP

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  8. GET /api/businesses

    list_businesses

    Lista los negocios

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  9. POST /api/businesses

    create_business

    Crea el borrador de un negocio

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  10. GET /api/businesses/{slug}

    get_business

    Un negocio

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  11. GET /api/businesses/{slug}/artifacts

    get_business_artifacts

    Los artefactos que un negocio instala en su dominio, con su clave

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  12. POST /api/businesses/{slug}/channel/resend-confirmation

    resend_channel_confirmation

    Reenvia la confirmacion del canal

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  13. GET /api/businesses/{slug}/diagnosis

    get_business_diagnosis

    El diagnóstico y el plan del negocio, con su clave; nunca público

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  14. PUT /api/businesses/{slug}/diagnosis

    deliver_business_diagnosis

    Solo para el enjambre, con firma: entrega el borrador medido contra un pedido pendiente

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  15. POST /api/businesses/{slug}/diagnosis/request

    request_business_diagnosis

    Le pide al enjambre el diagnóstico del negocio, con su clave

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  16. GET /api/businesses/{slug}/kit

    get_business_kit

    El kit del negocio para dárselo a su agente: un AGENTS.md con los pasos para vender y la verificación de cada uno, con su clave

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  17. GET /api/businesses/{slug}/log

    get_business_log

    La bitacora de un negocio, solo lectura

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  18. PUT /api/businesses/{slug}/manifest

    put_business_manifest

    Cambia el manifiesto de un negocio

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  19. POST /api/businesses/{slug}/plan

    create_business_plan

    El plan de integración de un negocio, con su clave

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  20. GET /api/businesses/{slug}/preview

    preview_business

    Cómo va a quedar lo público de un negocio, antes de publicarlo

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  21. POST /api/businesses/{slug}/publish

    publish_business

    Publica un negocio

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  22. GET /api/businesses/{slug}/quotes

    list_quotes

    Lista las cotizaciones de un negocio, redactadas

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  23. POST /api/businesses/{slug}/quotes

    request_quote

    Pide una cotizacion a un negocio, sin credencial; con `datos`, los que pide el contrato de la oferta, y 422 `faltan_datos` si falta uno para cotizar

    API Vivo MCP Vivo SDK Muy pronto CLI Muy pronto

  24. GET /api/businesses/{slug}/quotes/{quote_id}

    get_quote

    Una cotizacion, para el agente que la pidio, con el bloque pago

    API Solo lectura MCP Solo lectura SDK Muy pronto CLI Muy pronto

  25. POST /api/businesses/{slug}/quotes/{quote_id}/accept

    accept_quote

    El pedidor acepta lo que afirmo el negocio

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  26. POST /api/businesses/{slug}/quotes/{quote_id}/confirm

    confirm_quote

    El negocio confirma lo pagado

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  27. POST /api/businesses/{slug}/quotes/{quote_id}/mark-paid

    state_quote_paid

    El negocio afirma que le pagaron; Emporium no lo verifica

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  28. POST /api/businesses/{slug}/terms

    accept_terms

    Acepta los terminos

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  29. POST /api/businesses/{slug}/unpublish

    unpublish_business

    Despublica un negocio

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  30. GET /api/businesses/{slug}/use-cases

    get_business_use_cases

    Los casos de uso de un negocio publicado y los huecos que cierra, por categoría

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  31. POST /api/businesses/{slug}/verification/checks

    read_domain_proof

    Lee la prueba del dominio

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  32. POST /api/businesses/{slug}/verification/token

    renew_verification_token

    Pide un token de verificacion nuevo

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  33. GET /api/channel/confirm/{token}

    confirm_channel

    Confirma el canal con un enlace de un solo uso

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  34. GET /api/configuration

    get_configuration

    Que tiene configurado este despliegue: solo booleanos y enums

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  35. GET /api/directory

    search_directory

    Busca un servicio en la guia; lo que buscas se guarda en privado para mejorar el motor (que se guarda y por cuanto tiempo: /privacy)

    API Solo lectura MCP Solo lectura SDK Muy pronto CLI Solo lectura

  36. GET /api/directory/categories

    list_directory_by_category

    Las paginas amarillas, por categoria: cada negocio dado de alta y cada API de pago por uso admitida, con como llamarla; primero los negocios dados de alta

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  37. GET /api/flow

    get_flow

    El registro de flujo agregado

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  38. GET /api/flow/chart.svg

    get_flow_chart

    El grafico del rio, en SVG

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  39. GET /api/offer

    get_offer

    La oferta por proposito, generada del catalogo: cada capacidad con sus patrones de negocio, su estado y sus tools

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  40. GET /api/swarm/requests

    list_pending_diagnoses

    Solo para el enjambre, con firma: los pedidos de diagnóstico pendientes (slug, dominio y fecha)

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  41. GET /api/wallet/onboarding

    get_wallet_onboarding

    Como darle a tu agente una billetera con PayBox, la no custodial por omision: los cuatro pasos, y el MCP, la CLI y el SDK de TypeScript de PayBox con lo que se copia; ?idioma=es|en. La misma guia que emporium_wallet_onboarding

    API Solo lectura MCP Solo lectura SDK Muy pronto CLI Solo lectura

  42. GET /auth.md

    get_auth_md

    A quién autentica Emporium: a quien entra con PayBox, en la web y para usar el MCP (OAuth 2.1)

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  43. POST /counter/mcp

    call_counter_mcp

    El mostrador: las tools de lectura de las superficies de la casa, reenviadas, y los combos de la casa

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  44. GET /developers

    get_developers_page

    La página para desarrolladores en inglés, generada del catálogo y del contrato: los bloques con el estado de su API, MCP, SDK y CLI, la misma llamada de cuatro maneras, los kits, las reglas y todo lo del contrato

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  45. GET /directory

    get_directory_page

    El catalogo para quien construye: que hace cada entrada, su protocolo, el precio que pide quien la vende y su punto de entrada

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  46. GET /directory/categories

    get_directory_categories_page

    El catalogo por categoria, para quien busca un servicio: las mismas entradas que la busqueda, agrupadas

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  47. GET /directory/categories/en

    get_directory_categories_page_en

    El catalogo por categoria, en ingles

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  48. GET /directory/en

    get_directory_page_en

    El catalogo, en ingles

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  49. GET /docs

    get_api_reference

    La referencia de la API para personas en inglés, generada del contrato: cada operación con su método, su ruta, qué hace y su estado en API, MCP, SDK y CLI

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  50. GET /docs/{operation_id}

    get_operation_reference

    La página de referencia de una operación en inglés, por su operationId: por dónde se llega, sus parámetros, su cuerpo, sus respuestas y los esquemas que nombra

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  51. GET /es

    get_front_page_es

    La portada en castellano: la misma que /, en castellano; con Accept: text/markdown, el cuerpo de /index.md

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  52. GET /es/developers

    get_developers_page_es

    La página para desarrolladores en castellano: la misma que /developers, en castellano

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  53. GET /es/docs

    get_api_reference_es

    La referencia de la API, en castellano

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  54. GET /es/docs/{operation_id}

    get_operation_reference_es

    La página de referencia de una operación, en castellano

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  55. GET /flow

    get_flow_page

    El rio: lo que se pidio y con que se respondio

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  56. GET /health

    get_health

    Salud del servicio, sin I/O

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  57. GET /index.md

    get_index_md

    La portada para un agente, en Markdown

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  58. GET /llms-full.txt

    get_llms_full_txt

    Todos los documentos para agentes, en uno

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  59. GET /llms.txt

    get_llms_txt

    Que es Emporium, para un agente

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  60. POST /mcp

    call_mcp

    El MCP de Emporium, con un token OAuth 2.1 de Emporium (entrar con PayBox): las seis tools de la casa, las tres de un negocio por su slug y las billeteras de la persona, de lectura

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  61. GET /n/{slug}

    get_business_profile

    La ficha publica de un negocio

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  62. GET /n/{slug}/en

    get_business_profile_en

    La ficha publica de un negocio, en ingles

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  63. GET /n/{slug}/manifest.json

    get_business_manifest

    El manifiesto publico de un negocio

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  64. POST /n/{slug}/mcp

    call_business_mcp

    El MCP de un negocio publicado, en `<EMPORIUM_BASE_URL>/n/<slug>/mcp` con el `slug` que da `emporium_search_service`: JSON-RPC 2.0 como `/mcp`, sin credencial y con la cabecera `Accept: application/json, text/event-stream`; `{"jsonrpc":"2.0","id":1,"method":"tools/list"}` lista sus tres tools, `<slug>_ficha`, `<slug>_catalogo` y `<slug>_pedir_cotizacion` (cada `-` del slug escrito `_`)

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  65. GET /n/{slug}/offers/{offer_id}/slots

    get_offer_slots

    Las franjas libres de una oferta reservable, con las retenciones vigentes respetadas

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  66. GET /openapi.json

    get_openapi

    Este documento

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  67. GET /privacy

    get_privacy_page

    Que guarda Emporium de cada busqueda en la guia, por cuanto tiempo y quien lo lee

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  68. GET /r/{token}

    get_quote_reply_form

    El formulario de respuesta del negocio; no consume el enlace

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  69. POST /r/{token}

    reply_to_quote

    El negocio responde y consume el enlace

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  70. GET /robots.txt

    get_robots_txt

    Que puede leer un rastreador

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  71. GET /signup

    get_signup_page

    Sumá tu negocio: pegá tu dominio, pedí tu diagnóstico y miralo, sin JSON ni JavaScript

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  72. POST /signup

    submit_signup_form

    El formulario de la página: crea el borrador y muestra la clave una vez

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  73. GET /signup/en

    get_signup_page_en

    La misma página, en inglés

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  74. POST /signup/kit

    submit_kit_download_form

    El formulario de la página: baja el kit, con slug y clave

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  75. POST /signup/publish

    submit_publish_form

    El formulario de la página: publica el negocio, con slug y clave

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  76. POST /signup/request

    submit_diagnosis_request_form

    El formulario de la página: el pedido del diagnóstico

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  77. POST /signup/status

    submit_diagnosis_status_form

    El formulario de la página: el reporte del diagnóstico, con slug y clave

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  78. POST /signup/terms

    submit_terms_form

    El formulario de la página: acepta los términos vigentes, con slug, clave y la casilla marcada

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  79. POST /signup/verification/checks

    submit_domain_check_form

    El formulario de la página: lee la prueba del dominio, con slug y clave

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  80. POST /signup/verification/token

    submit_new_token_form

    El formulario de la página: un token de verificación nuevo, con slug y clave

    API Vivo MCP Muy pronto SDK Muy pronto CLI Muy pronto

  81. GET /sitemap.xml

    get_sitemap

    Las paginas y los documentos publicos

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  82. GET /skill.md

    get_skill_md

    El manual para un agente: los flujos y los errores

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

  83. GET /terms/{version}

    get_terms

    El texto de una version de los terminos

    API Solo lectura MCP Muy pronto SDK Muy pronto CLI Muy pronto

Vivo: se usa hoy, para leer y para escribir. Solo lectura: hoy se lee y no se escribe. Muy pronto: todavía no está.

Las tools de la casa que no tienen una ruta HTTP gemela no tienen página acá: las listan, con el porqué, la página para desarrolladores, /llms.txt y el tools/list de cada MCP.

Lo mismo, para una máquina