{ "openapi": "3.1.0", "info": { "title": "LORENGRAFF public API", "version": "1.1.0", "description": "LORENGRAFF Technologies, Inc.: DevSecOps web development, iOS/Android apps, cybersecurity consulting, SEO/AEO, secure business email, remote IT support and managed digital-presence plans. Based in Las Terrenas, Samaná (Dominican Republic); serves clients worldwide in Spanish, English and French. Read-only catalog, contact requests and checkout hand-off. Payments are completed on the official hosted checkout (PayPal for LORENGRAFF Business and the official lorengraff.net store).", "contact": { "name": "LORENGRAFF Technologies, Inc.", "email": "info@lorengraff.net", "url": "https://lorengraff.net/" }, "termsOfService": "https://lorengraff.net/terminos/" }, "servers": [ { "url": "https://lorengraff.net" } ], "x-service-info": { "categories": [ "web-development", "devsecops", "mobile-apps", "cybersecurity", "seo", "aeo", "business-email", "it-support" ], "docs": "https://lorengraff.net/llms.txt", "mcp": "https://lorengraff.net/mcp" }, "components": { "securitySchemes": { "agentToken": { "type": "http", "scheme": "bearer", "description": "Optional. Obtain at POST /agent/register (see /auth.md)." } }, "schemas": { "Contact": { "type": "object", "required": [ "name", "email", "message", "consent" ], "properties": { "name": { "type": "string", "maxLength": 120 }, "email": { "type": "string", "format": "email" }, "subject": { "type": "string", "maxLength": 150 }, "message": { "type": "string", "maxLength": 4000 }, "lang": { "type": "string", "enum": [ "es", "en", "fr" ] }, "consent": { "type": "boolean", "description": "The person accepted the privacy policy and asked to send the message." } } } } }, "paths": { "/api/v1": { "get": { "operationId": "apiInfo", "summary": "API information", "responses": { "200": { "description": "Endpoints and links" } } } }, "/api/v1/services": { "get": { "operationId": "listServices", "summary": "List services", "parameters": [ { "name": "lang", "in": "query", "schema": { "type": "string", "enum": [ "es", "en", "fr" ] } } ], "responses": { "200": { "description": "Services with features, FAQ and URLs" } } } }, "/api/v1/services/{id}": { "get": { "operationId": "getService", "summary": "Get one service", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "devsecops", "mobile", "security", "seo", "support", "email" ] } }, { "name": "lang", "in": "query", "schema": { "type": "string", "enum": [ "es", "en", "fr" ] } } ], "responses": { "200": { "description": "Service" }, "404": { "description": "Unknown service" } } } }, "/api/v1/products": { "get": { "operationId": "listProducts", "summary": "Store catalog: hosting, VPS, domains, security, email and IT products with monthly/annual prices", "parameters": [ { "name": "lang", "in": "query", "schema": { "type": "string", "enum": [ "es", "en", "fr" ] } }, { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "category", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Products with offers (price, currency, interval, checkout_url)" } } } }, "/api/v1/products/{id}": { "get": { "operationId": "getProduct", "summary": "Get one store product", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "svc-1", "svc-9", "svc-10", "svc-11", "svc-13", "svc-14", "svc-15", "svc-17", "svc-20", "svc-24", "svc-25", "svc-26", "svc-28", "svc-29", "svc-32", "svc-33", "svc-34", "svc-36", "svc-37", "svc-39", "svc-40", "svc-41", "svc-43", "svc-44", "svc-45", "svc-46", "svc-47", "svc-48", "svc-49", "svc-50", "svc-51" ] } }, { "name": "lang", "in": "query", "schema": { "type": "string", "enum": [ "es", "en", "fr" ] } } ], "responses": { "200": { "description": "Product" }, "404": { "description": "Unknown product" } } } }, "/api/v1/checkout": { "post": { "operationId": "createCheckout", "summary": "Prepare a store purchase: returns 402 with a checkout_url where the person approves payment in PayPal", "x-payment-info": { "intent": "session", "method": "paypal", "amount": 199, "currency": "USD", "description": "Hosted PayPal checkout (cards accepted). Exact amount depends on product_id and cycle.", "options": [ { "product_id": "svc-1", "name": "Starter Cloud Hosting Plan", "cycle": "monthly", "amount": 999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-1&cycle=monthly" }, { "product_id": "svc-1", "name": "Starter Cloud Hosting Plan", "cycle": "annually", "amount": 9499, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-1&cycle=annually" }, { "product_id": "svc-9", "name": "Corporate Email @yourdomain.com", "cycle": "monthly", "amount": 199, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-9&cycle=monthly" }, { "product_id": "svc-9", "name": "Corporate Email @yourdomain.com", "cycle": "annually", "amount": 1999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-9&cycle=annually" }, { "product_id": "svc-10", "name": "Elite+ Cloud Hosting Plan", "cycle": "monthly", "amount": 22999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-10&cycle=monthly" }, { "product_id": "svc-10", "name": "Elite+ Cloud Hosting Plan", "cycle": "annually", "amount": 269999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-10&cycle=annually" }, { "product_id": "svc-11", "name": "Growth Cloud Hosting Plan", "cycle": "monthly", "amount": 1999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-11&cycle=monthly" }, { "product_id": "svc-11", "name": "Growth Cloud Hosting Plan", "cycle": "annually", "amount": 18999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-11&cycle=annually" }, { "product_id": "svc-13", "name": "RapidSSL", "cycle": "annually", "amount": 1795, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-13&cycle=annually" }, { "product_id": "svc-14", "name": "RapidSSL Wildcard", "cycle": "annually", "amount": 14900, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-14&cycle=annually" }, { "product_id": "svc-15", "name": "GeoTrust QuickSSL Premium", "cycle": "annually", "amount": 7900, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-15&cycle=annually" }, { "product_id": "svc-17", "name": "GeoTrust True BusinessID", "cycle": "annually", "amount": 16900, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-17&cycle=annually" }, { "product_id": "svc-20", "name": "DigiCert Secure Site", "cycle": "annually", "amount": 44800, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-20&cycle=annually" }, { "product_id": "svc-24", "name": "Incoming Scanning", "cycle": "monthly", "amount": 299, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-24&cycle=monthly" }, { "product_id": "svc-24", "name": "Incoming Scanning", "cycle": "annually", "amount": 3588, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-24&cycle=annually" }, { "product_id": "svc-25", "name": "Outgoing Scanning", "cycle": "monthly", "amount": 299, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-25&cycle=monthly" }, { "product_id": "svc-25", "name": "Outgoing Scanning", "cycle": "annually", "amount": 3588, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-25&cycle=annually" }, { "product_id": "svc-26", "name": "Incoming & Archiving Bundle", "cycle": "monthly", "amount": 699, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-26&cycle=monthly" }, { "product_id": "svc-26", "name": "Incoming & Archiving Bundle", "cycle": "annually", "amount": 6899, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-26&cycle=annually" }, { "product_id": "svc-28", "name": "Incoming & Outgoing Bundle", "cycle": "monthly", "amount": 598, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-28&cycle=monthly" }, { "product_id": "svc-28", "name": "Incoming & Outgoing Bundle", "cycle": "annually", "amount": 7176, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-28&cycle=annually" }, { "product_id": "svc-29", "name": "Incoming, Outgoing & Archiving Bundle", "cycle": "monthly", "amount": 1047, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-29&cycle=monthly" }, { "product_id": "svc-29", "name": "Incoming, Outgoing & Archiving Bundle", "cycle": "annually", "amount": 12564, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-29&cycle=annually" }, { "product_id": "svc-32", "name": "Fix", "cycle": "monthly", "amount": 1499, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-32&cycle=monthly" }, { "product_id": "svc-32", "name": "Fix", "cycle": "annually", "amount": 9999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-32&cycle=annually" }, { "product_id": "svc-33", "name": "Defend", "cycle": "monthly", "amount": 4999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-33&cycle=monthly" }, { "product_id": "svc-33", "name": "Defend", "cycle": "annually", "amount": 29999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-33&cycle=annually" }, { "product_id": "svc-34", "name": "Emergency", "cycle": "monthly", "amount": 19999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-34&cycle=monthly" }, { "product_id": "svc-36", "name": "Personal", "cycle": "monthly", "amount": 199, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-36&cycle=monthly" }, { "product_id": "svc-36", "name": "Personal", "cycle": "annually", "amount": 1999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-36&cycle=annually" }, { "product_id": "svc-37", "name": "Plus", "cycle": "monthly", "amount": 299, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-37&cycle=monthly" }, { "product_id": "svc-37", "name": "Plus", "cycle": "annually", "amount": 2999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-37&cycle=annually" }, { "product_id": "svc-39", "name": "Pro", "cycle": "monthly", "amount": 499, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-39&cycle=monthly" }, { "product_id": "svc-39", "name": "Pro", "cycle": "annually", "amount": 4999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-39&cycle=annually" }, { "product_id": "svc-40", "name": "Business", "cycle": "monthly", "amount": 2499, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-40&cycle=monthly" }, { "product_id": "svc-40", "name": "Business", "cycle": "annually", "amount": 24999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-40&cycle=annually" }, { "product_id": "svc-41", "name": "Enterprise", "cycle": "monthly", "amount": 9999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-41&cycle=monthly" }, { "product_id": "svc-41", "name": "Enterprise", "cycle": "annually", "amount": 99999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-41&cycle=annually" }, { "product_id": "svc-43", "name": "Pro", "cycle": "monthly", "amount": 999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-43&cycle=monthly" }, { "product_id": "svc-43", "name": "Pro", "cycle": "annually", "amount": 11988, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-43&cycle=annually" }, { "product_id": "svc-44", "name": "Scale Cloud Hosting Plan", "cycle": "monthly", "amount": 7999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-44&cycle=monthly" }, { "product_id": "svc-44", "name": "Scale Cloud Hosting Plan", "cycle": "annually", "amount": 79999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-44&cycle=annually" }, { "product_id": "svc-45", "name": "Full Webmaster Services Plan", "cycle": "monthly", "amount": 43999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-45&cycle=monthly" }, { "product_id": "svc-45", "name": "Full Webmaster Services Plan", "cycle": "annually", "amount": 499999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-45&cycle=annually" }, { "product_id": "svc-46", "name": "Maintenance & Content Edition Plan", "cycle": "monthly", "amount": 29999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-46&cycle=monthly" }, { "product_id": "svc-46", "name": "Maintenance & Content Edition Plan", "cycle": "annually", "amount": 299999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-46&cycle=annually" }, { "product_id": "svc-47", "name": "Managed WordPress Care Plan", "cycle": "monthly", "amount": 19999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-47&cycle=monthly" }, { "product_id": "svc-47", "name": "Managed WordPress Care Plan", "cycle": "annually", "amount": 199999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-47&cycle=annually" }, { "product_id": "svc-48", "name": "Plan Esencial Security", "cycle": "monthly", "amount": 7499, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-48&cycle=monthly" }, { "product_id": "svc-48", "name": "Plan Esencial Security", "cycle": "annually", "amount": 74999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-48&cycle=annually" }, { "product_id": "svc-49", "name": "Pro Brand Security Plan", "cycle": "monthly", "amount": 14999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-49&cycle=monthly" }, { "product_id": "svc-49", "name": "Pro Brand Security Plan", "cycle": "annually", "amount": 149999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-49&cycle=annually" }, { "product_id": "svc-50", "name": "Corporate Brand Security Plan", "cycle": "monthly", "amount": 29999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-50&cycle=monthly" }, { "product_id": "svc-50", "name": "Corporate Brand Security Plan", "cycle": "annually", "amount": 299999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-50&cycle=annually" }, { "product_id": "svc-51", "name": "Elite Brand Security Plan", "cycle": "monthly", "amount": 49999, "currency": "USD", "interval": "month", "checkout_url": "https://lorengraff.net/en/store/?add=svc-51&cycle=monthly" }, { "product_id": "svc-51", "name": "Elite Brand Security Plan", "cycle": "annually", "amount": 499999, "currency": "USD", "interval": "year", "checkout_url": "https://lorengraff.net/en/store/?add=svc-51&cycle=annually" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "product_id" ], "properties": { "product_id": { "type": "string", "enum": [ "svc-1", "svc-9", "svc-10", "svc-11", "svc-13", "svc-14", "svc-15", "svc-17", "svc-20", "svc-24", "svc-25", "svc-26", "svc-28", "svc-29", "svc-32", "svc-33", "svc-34", "svc-36", "svc-37", "svc-39", "svc-40", "svc-41", "svc-43", "svc-44", "svc-45", "svc-46", "svc-47", "svc-48", "svc-49", "svc-50", "svc-51" ] }, "cycle": { "type": "string", "enum": [ "monthly", "annually" ], "default": "monthly" }, "lang": { "type": "string", "enum": [ "es", "en", "fr" ] } } } } } }, "responses": { "402": { "description": "Payment required: open checkout_url" }, "404": { "description": "Unknown product" }, "422": { "description": "Unknown cycle" } } } }, "/api/v1/plans": { "get": { "operationId": "listPlans", "summary": "List plans with prices and checkout links", "parameters": [ { "name": "lang", "in": "query", "schema": { "type": "string", "enum": [ "es", "en", "fr" ] } } ], "responses": { "200": { "description": "Plans" } } } }, "/api/v1/plans/subscribe": { "post": { "operationId": "subscribePlan", "summary": "Start a subscription: returns 402 with the official hosted checkout link", "description": "The person completes payment at checkout_url. Prices: business-starter $30/month, business-pro $60/month, business-business $100+/month, business-email $1.99+/month.", "x-payment-info": { "intent": "session", "method": "card", "amount": 199, "currency": "USD", "description": "Hosted checkout (PayPal, cards accepted). Amount shown is the lowest monthly plan; the exact amount depends on plan_id.", "options": [ { "plan_id": "business-starter", "amount": 3000, "currency": "USD", "interval": "month", "checkout_url": "https://business.lorengraff.net/onboarding?plan=starter" }, { "plan_id": "business-pro", "amount": 6000, "currency": "USD", "interval": "month", "checkout_url": "https://business.lorengraff.net/onboarding?plan=pro" }, { "plan_id": "business-business", "amount": 10000, "currency": "USD", "interval": "month", "checkout_url": "https://business.lorengraff.net/onboarding?plan=business" }, { "plan_id": "business-email", "amount": 199, "currency": "USD", "interval": "month", "checkout_url": "/tienda/" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "plan_id" ], "properties": { "plan_id": { "type": "string", "enum": [ "business", "corporate", "pro", "business-starter", "business-pro", "business-business", "business-email" ] }, "lang": { "type": "string", "enum": [ "es", "en", "fr" ] } } } } } }, "responses": { "402": { "description": "Payment required: open checkout_url" }, "404": { "description": "Unknown plan" } } } }, "/api/v1/contact": { "get": { "operationId": "getContact", "summary": "Official contact channels", "responses": { "200": { "description": "Contact info" } } }, "post": { "operationId": "sendContact", "summary": "Send a quote request to the LORENGRAFF team", "security": [ [], { "agentToken": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Contact" } } } }, "responses": { "200": { "description": "Delivered" }, "422": { "description": "Missing fields or consent" }, "429": { "description": "Rate limited" } } } }, "/agent/register": { "post": { "operationId": "registerAgent", "summary": "Register an agent (anonymous) and get a bearer token", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "agent_name": { "type": "string" }, "requested_scopes": { "type": "array", "items": { "type": "string", "enum": [ "read:services", "read:plans", "read:products", "submit:inquiry" ] } } } } } } }, "responses": { "201": { "description": "client_id, client_secret and access_token" } } } }, "/agent/token": { "post": { "operationId": "agentToken", "summary": "client_credentials token", "responses": { "200": { "description": "Access token" }, "401": { "description": "invalid_client" } } } }, "/agent/revoke": { "post": { "operationId": "revokeAgentToken", "summary": "Revoke a token", "responses": { "200": { "description": "Revoked" } } } }, "/mcp": { "post": { "operationId": "mcp", "summary": "Model Context Protocol endpoint (JSON-RPC 2.0, Streamable HTTP)", "responses": { "200": { "description": "JSON-RPC response" } } } } } }