{ "variable": [ { "id": "baseUrl", "key": "baseUrl", "type": "string", "name": "string", "value": "https:\/\/interteam-api.adtv.io" } ], "info": { "name": "InterteamApiDev API Documentation", "_postman_id": "0720cada-8f59-4ab2-852f-6d905e4a974e", "description": "API Gateway \/ Integration Bridge para interconectar sistemas legacy. Valida, mapea y sincroniza datos entre bases de datos mediante servicios configurables.", "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json" }, "item": [ { "name": "Integrations", "description": "\nEndpoints din\u00e1micos para ejecutar integraciones configurables.\nCada servicio valida datos, mapea campos y ejecuta operaciones (insert\/update\/upsert) en la base de datos destino.", "item": [ { "name": "Ejecutar integraci\u00f3n", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/integrations\/:slug", "query": [ { "key": "dry_run", "value": "", "description": "opcional. Si es 'true', valida y mapea datos sin persistir.", "disabled": true } ], "raw": "{{baseUrl}}\/api\/v1\/integrations\/:slug?dry_run=", "variable": [ { "id": "slug", "key": "slug", "value": "revalidaciones", "description": "El slug del servicio de integraci\u00f3n (ej: revalidaciones, detalle-contenedores)." } ] }, "method": "POST", "header": [ { "key": "X-Correlation-Id", "value": "string opcional. ID de correlaci\u00f3n para tracking (se genera autom\u00e1ticamente si no se proporciona). Example: uuid-12345-abcde" }, { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"referencia_id\":12345,\"fecha_evento\":\"2026-02-03\",\"contenedor\":\"ABCD1234567\",\"estatus\":\"validado\"}" }, "description": "Procesa una solicitud de integraci\u00f3n para un servicio espec\u00edfico.\nEl servicio debe estar configurado en `integration_services` y habilitado." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"data\": {\n \"operation\": \"update\",\n \"existed\": true\n },\n \"correlation_id\": \"uuid-12345-abcde\",\n \"status_code\": 200\n}", "name": "Update\/Upsert exitoso" }, { "header": [], "code": 201, "body": "{\n \"success\": true,\n \"data\": {\n \"id\": 1,\n \"operation\": \"insert\"\n },\n \"correlation_id\": \"uuid-12345-abcde\",\n \"status_code\": 201\n}", "name": "Insert exitoso" }, { "header": [], "code": 401, "body": "{\n \"message\": \"Unauthorized - Invalid, expired, or revoked token\",\n \"error_code\": \"AUTH_INVALID_TOKEN\"\n}", "name": "Token inv\u00e1lido" }, { "header": [], "code": 403, "body": "{\n \"message\": \"Integration service is disabled\",\n \"error_code\": \"SERVICE_DISABLED\"\n}", "name": "Servicio deshabilitado" }, { "header": [], "code": 404, "body": "{\n \"message\": \"Integration service not found\",\n \"error_code\": \"SERVICE_NOT_FOUND\"\n}", "name": "Servicio no encontrado" }, { "header": [], "code": 422, "body": "{\n \"success\": false,\n \"message\": \"Validation failed\",\n \"error_code\": \"VALIDATION_ERROR\",\n \"correlation_id\": \"uuid-12345-abcde\",\n \"details\": {\n \"errors\": {\n \"estatus\": [\"The estatus field must be one of: pendiente, validado, rechazado.\"]\n }\n },\n \"status_code\": 422\n}", "name": "Error de validaci\u00f3n" } ] }, { "name": "Ejecutar integraci\u00f3n", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/integrations\/:slug", "query": [ { "key": "dry_run", "value": "", "description": "opcional. Si es 'true', valida y mapea datos sin persistir.", "disabled": true } ], "raw": "{{baseUrl}}\/api\/v1\/integrations\/:slug?dry_run=", "variable": [ { "id": "slug", "key": "slug", "value": "revalidaciones", "description": "El slug del servicio de integraci\u00f3n (ej: revalidaciones, detalle-contenedores)." } ] }, "method": "PUT", "header": [ { "key": "X-Correlation-Id", "value": "string opcional. ID de correlaci\u00f3n para tracking (se genera autom\u00e1ticamente si no se proporciona). Example: uuid-12345-abcde" }, { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"referencia_id\":12345,\"fecha_evento\":\"2026-02-03\",\"contenedor\":\"ABCD1234567\",\"estatus\":\"validado\"}" }, "description": "Procesa una solicitud de integraci\u00f3n para un servicio espec\u00edfico.\nEl servicio debe estar configurado en `integration_services` y habilitado." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"data\": {\n \"operation\": \"update\",\n \"existed\": true\n },\n \"correlation_id\": \"uuid-12345-abcde\",\n \"status_code\": 200\n}", "name": "Update\/Upsert exitoso" }, { "header": [], "code": 201, "body": "{\n \"success\": true,\n \"data\": {\n \"id\": 1,\n \"operation\": \"insert\"\n },\n \"correlation_id\": \"uuid-12345-abcde\",\n \"status_code\": 201\n}", "name": "Insert exitoso" }, { "header": [], "code": 401, "body": "{\n \"message\": \"Unauthorized - Invalid, expired, or revoked token\",\n \"error_code\": \"AUTH_INVALID_TOKEN\"\n}", "name": "Token inv\u00e1lido" }, { "header": [], "code": 403, "body": "{\n \"message\": \"Integration service is disabled\",\n \"error_code\": \"SERVICE_DISABLED\"\n}", "name": "Servicio deshabilitado" }, { "header": [], "code": 404, "body": "{\n \"message\": \"Integration service not found\",\n \"error_code\": \"SERVICE_NOT_FOUND\"\n}", "name": "Servicio no encontrado" }, { "header": [], "code": 422, "body": "{\n \"success\": false,\n \"message\": \"Validation failed\",\n \"error_code\": \"VALIDATION_ERROR\",\n \"correlation_id\": \"uuid-12345-abcde\",\n \"details\": {\n \"errors\": {\n \"estatus\": [\"The estatus field must be one of: pendiente, validado, rechazado.\"]\n }\n },\n \"status_code\": 422\n}", "name": "Error de validaci\u00f3n" } ] }, { "name": "Ejecutar integraci\u00f3n", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/integrations\/:slug", "query": [ { "key": "dry_run", "value": "", "description": "opcional. Si es 'true', valida y mapea datos sin persistir.", "disabled": true } ], "raw": "{{baseUrl}}\/api\/v1\/integrations\/:slug?dry_run=", "variable": [ { "id": "slug", "key": "slug", "value": "revalidaciones", "description": "El slug del servicio de integraci\u00f3n (ej: revalidaciones, detalle-contenedores)." } ] }, "method": "PATCH", "header": [ { "key": "X-Correlation-Id", "value": "string opcional. ID de correlaci\u00f3n para tracking (se genera autom\u00e1ticamente si no se proporciona). Example: uuid-12345-abcde" }, { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"referencia_id\":12345,\"fecha_evento\":\"2026-02-03\",\"contenedor\":\"ABCD1234567\",\"estatus\":\"validado\"}" }, "description": "Procesa una solicitud de integraci\u00f3n para un servicio espec\u00edfico.\nEl servicio debe estar configurado en `integration_services` y habilitado." }, "response": [ { "header": [], "code": 200, "body": "{\n \"success\": true,\n \"data\": {\n \"operation\": \"update\",\n \"existed\": true\n },\n \"correlation_id\": \"uuid-12345-abcde\",\n \"status_code\": 200\n}", "name": "Update\/Upsert exitoso" }, { "header": [], "code": 201, "body": "{\n \"success\": true,\n \"data\": {\n \"id\": 1,\n \"operation\": \"insert\"\n },\n \"correlation_id\": \"uuid-12345-abcde\",\n \"status_code\": 201\n}", "name": "Insert exitoso" }, { "header": [], "code": 401, "body": "{\n \"message\": \"Unauthorized - Invalid, expired, or revoked token\",\n \"error_code\": \"AUTH_INVALID_TOKEN\"\n}", "name": "Token inv\u00e1lido" }, { "header": [], "code": 403, "body": "{\n \"message\": \"Integration service is disabled\",\n \"error_code\": \"SERVICE_DISABLED\"\n}", "name": "Servicio deshabilitado" }, { "header": [], "code": 404, "body": "{\n \"message\": \"Integration service not found\",\n \"error_code\": \"SERVICE_NOT_FOUND\"\n}", "name": "Servicio no encontrado" }, { "header": [], "code": 422, "body": "{\n \"success\": false,\n \"message\": \"Validation failed\",\n \"error_code\": \"VALIDATION_ERROR\",\n \"correlation_id\": \"uuid-12345-abcde\",\n \"details\": {\n \"errors\": {\n \"estatus\": [\"The estatus field must be one of: pendiente, validado, rechazado.\"]\n }\n },\n \"status_code\": 422\n}", "name": "Error de validaci\u00f3n" } ] } ] }, { "name": "Admin - Services", "description": "\nAPIs for managing integration service configurations.", "item": [ { "name": "List all services", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/services", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/services" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Revalidaciones\",\n \"slug\": \"revalidaciones\",\n \"is_enabled\": true,\n \"source_connection\": \"source_db\",\n \"target_connection\": \"target_db\",\n \"endpoint_path\": \"\/v1\/integrations\/revalidaciones\",\n \"http_method\": \"POST\",\n \"validation_rules\": {...},\n \"mapping\": {...},\n \"operation\": \"upsert\",\n \"target_table\": \"revalidaciones\",\n \"created_at\": \"2026-02-01T10:00:00.000000Z\",\n \"updated_at\": \"2026-02-01T10:00:00.000000Z\"\n }\n ]\n}", "name": "" } ] }, { "name": "Create new service", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/services", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/services" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Revalidaciones\",\"slug\":\"revalidaciones\",\"is_enabled\":true,\"source_connection\":\"source_db\",\"target_connection\":\"target_db\",\"endpoint_path\":\"\\\/v1\\\/integrations\\\/revalidaciones\",\"http_method\":\"POST\",\"idempotency_key_strategy\":\"hash:referencia_id,fecha_evento\",\"validation_rules\":[],\"mapping\":[],\"operation\":\"upsert\",\"target_table\":\"revalidaciones\",\"target_model\":\"architecto\",\"match_keys\":[\"architecto\"],\"preconditions\":[\"architecto\"],\"post_actions\":[\"architecto\"],\"rate_limit_per_min\":16}" }, "description": "" }, "response": [ { "header": [], "code": 201, "body": "{\n \"data\": {\n \"id\": 2,\n \"name\": \"Revalidaciones\",\n \"slug\": \"revalidaciones\",\n \"is_enabled\": true,\n \"source_connection\": \"source_db\",\n \"target_connection\": \"target_db\",\n \"endpoint_path\": \"\/v1\/integrations\/revalidaciones\",\n \"http_method\": \"POST\",\n \"validation_rules\": {...},\n \"mapping\": {...},\n \"operation\": \"upsert\",\n \"target_table\": \"revalidaciones\",\n \"created_at\": \"2026-02-03T12:00:00.000000Z\",\n \"updated_at\": \"2026-02-03T12:00:00.000000Z\"\n }\n}", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"The name field is required.\",\n \"errors\": {\n \"name\": [\"The name field is required.\"]\n }\n}", "name": "" } ] }, { "name": "Get service details", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/services\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/services\/:id", "variable": [ { "id": "id", "key": "id", "value": "1", "description": "Service ID." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": {\n \"id\": 1,\n \"name\": \"Revalidaciones\",\n \"slug\": \"revalidaciones\",\n \"is_enabled\": true,\n \"source_connection\": \"source_db\",\n \"target_connection\": \"target_db\",\n \"endpoint_path\": \"\/v1\/integrations\/revalidaciones\",\n \"http_method\": \"POST\",\n \"validation_rules\": {...},\n \"mapping\": {...},\n \"operation\": \"upsert\",\n \"target_table\": \"revalidaciones\",\n \"created_at\": \"2026-02-01T10:00:00.000000Z\",\n \"updated_at\": \"2026-02-01T10:00:00.000000Z\"\n }\n}", "name": "" }, { "header": [], "code": 404, "body": "{\n \"message\": \"No query results for model [App\\\\Models\\\\IntegrationService] 999\"\n}", "name": "" } ] }, { "name": "Update service", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/services\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/services\/:id", "variable": [ { "id": "id", "key": "id", "value": "1", "description": "Service ID." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Revalidaciones Updated\",\"slug\":\"revalidaciones-v2\",\"is_enabled\":false,\"source_connection\":\"architecto\",\"target_connection\":\"architecto\",\"endpoint_path\":\"architecto\",\"http_method\":\"architecto\",\"idempotency_key_strategy\":\"architecto\",\"validation_rules\":[],\"mapping\":[],\"operation\":\"architecto\",\"target_table\":\"architecto\",\"target_model\":\"architecto\",\"match_keys\":[\"architecto\"],\"preconditions\":[\"architecto\"],\"post_actions\":[\"architecto\"],\"rate_limit_per_min\":16}" }, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": {\n \"id\": 1,\n \"name\": \"Revalidaciones Updated\",\n \"slug\": \"revalidaciones\",\n \"is_enabled\": false,\n \"updated_at\": \"2026-02-03T13:00:00.000000Z\"\n }\n}", "name": "" }, { "header": [], "code": 404, "body": "{\n \"message\": \"No query results for model [App\\\\Models\\\\IntegrationService] 999\"\n}", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"The slug has already been taken.\",\n \"errors\": {\n \"slug\": [\"The slug has already been taken.\"]\n }\n}", "name": "" } ] }, { "name": "Delete service", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/services\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/services\/:id", "variable": [ { "id": "id", "key": "id", "value": "1", "description": "Service ID." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\n \"message\": \"Service deleted successfully\"\n}", "name": "" }, { "header": [], "code": 404, "body": "{\n \"message\": \"No query results for model [App\\\\Models\\\\IntegrationService] 999\"\n}", "name": "" } ] } ] }, { "name": "Admin - Events", "description": "\nAPIs for querying integration event logs with filtering capabilities.", "item": [ { "name": "List integration events", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/events", "query": [ { "key": "service_slug", "value": "revalidaciones", "description": "Filter by service slug.", "disabled": false }, { "key": "status", "value": "success", "description": "Filter by event status (success, failed, validation_error).", "disabled": false }, { "key": "correlation_id", "value": "cid-123-abc", "description": "Filter by correlation ID for request tracing.", "disabled": false }, { "key": "date_from", "value": "2026-02-01T00%3A00%3A00Z", "description": "Filter events created on or after this date (ISO 8601).", "disabled": false }, { "key": "date_to", "value": "2026-02-03T23%3A59%3A59Z", "description": "Filter events created on or before this date (ISO 8601).", "disabled": false }, { "key": "per_page", "value": "20", "description": "Results per page (default: 50).", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/admin\/events?service_slug=revalidaciones&status=success&correlation_id=cid-123-abc&date_from=2026-02-01T00%3A00%3A00Z&date_to=2026-02-03T23%3A59%3A59Z&per_page=20" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Query integration event logs with optional filters. Results are paginated and ordered by creation date (newest first)." }, "response": [ { "header": [], "code": 200, "body": "{\n \"current_page\": 1,\n \"data\": [\n {\n \"id\": 123,\n \"service_slug\": \"revalidaciones\",\n \"client_id\": 1,\n \"status\": \"success\",\n \"correlation_id\": \"cid-123-abc\",\n \"request_payload\": {...},\n \"response_payload\": {...},\n \"error_message\": null,\n \"processing_time_ms\": 245,\n \"dry_run\": false,\n \"created_at\": \"2026-02-03T12:34:56.000000Z\",\n \"client\": {\n \"id\": 1,\n \"name\": \"Sistema Legacy A\"\n }\n }\n ],\n \"per_page\": 50,\n \"total\": 1500,\n \"last_page\": 30\n}", "name": "" } ] }, { "name": "Get event details", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/events\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/events\/:id", "variable": [ { "id": "id", "key": "id", "value": "123", "description": "Event ID." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieve detailed information about a specific integration event." }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": {\n \"id\": 123,\n \"service_slug\": \"revalidaciones\",\n \"client_id\": 1,\n \"status\": \"success\",\n \"correlation_id\": \"cid-123-abc\",\n \"request_payload\": {\n \"referencia_id\": \"REF-2026-001\",\n \"fecha_evento\": \"2026-02-03\",\n \"contenedor\": \"CONT-123\",\n \"estatus\": \"aprobado\"\n },\n \"response_payload\": {\n \"status\": \"success\",\n \"operation\": \"update\",\n \"affected_rows\": 1\n },\n \"error_message\": null,\n \"processing_time_ms\": 245,\n \"dry_run\": false,\n \"created_at\": \"2026-02-03T12:34:56.000000Z\",\n \"updated_at\": \"2026-02-03T12:34:56.000000Z\",\n \"client\": {\n \"id\": 1,\n \"name\": \"Sistema Legacy A\"\n }\n }\n}", "name": "" }, { "header": [], "code": 404, "body": "{\n \"message\": \"No query results for model [App\\\\Models\\\\IntegrationEvent] 999\"\n}", "name": "" } ] } ] }, { "name": "Admin - Metrics", "description": "\nAPIs for retrieving aggregated metrics and error statistics.", "item": [ { "name": "List daily metrics", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/metrics", "query": [ { "key": "service_slug", "value": "revalidaciones", "description": "Filter by service slug.", "disabled": false }, { "key": "date_from", "value": "2026-02-01", "description": "Filter metrics from this date (Y-m-d).", "disabled": false }, { "key": "date_to", "value": "2026-02-03", "description": "Filter metrics until this date (Y-m-d).", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/admin\/metrics?service_slug=revalidaciones&date_from=2026-02-01&date_to=2026-02-03" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieve daily aggregated metrics for integration services with optional filters." }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": [\n {\n \"id\": 5,\n \"service_slug\": \"revalidaciones\",\n \"date\": \"2026-02-03\",\n \"total_requests\": 1250,\n \"success_count\": 1200,\n \"fail_count\": 50,\n \"avg_duration_ms\": 245.50,\n \"max_duration_ms\": 1200,\n \"min_duration_ms\": 45,\n \"created_at\": \"2026-02-04T00:05:00.000000Z\",\n \"updated_at\": \"2026-02-04T23:59:00.000000Z\"\n }\n ]\n}", "name": "" } ] }, { "name": "Get top errors", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/metrics\/top-errors", "query": [ { "key": "date_from", "value": "2026-01-27", "description": "Start date for error analysis (Y-m-d, default: 7 days ago).", "disabled": false }, { "key": "date_to", "value": "2026-02-03", "description": "End date for error analysis (Y-m-d, default: today).", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/admin\/metrics\/top-errors?date_from=2026-01-27&date_to=2026-02-03" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieve the most frequent error codes grouped by service within a date range." }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": [\n {\n \"service_slug\": \"revalidaciones\",\n \"error_code\": \"VALIDATION_ERROR\",\n \"count\": 45,\n \"last_error_message\": \"The estatus field is required.\",\n \"last_occurred_at\": \"2026-02-03T15:30:00.000000Z\"\n },\n {\n \"service_slug\": \"revalidaciones\",\n \"error_code\": \"DATABASE_ERROR\",\n \"count\": 12,\n \"last_error_message\": \"Connection timeout\",\n \"last_occurred_at\": \"2026-02-03T14:20:00.000000Z\"\n }\n ]\n}", "name": "" } ] }, { "name": "Get metrics summary", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/metrics\/summary", "query": [ { "key": "service_slug", "value": "revalidaciones", "description": "Filter by service slug.", "disabled": false }, { "key": "date_from", "value": "2026-01-04", "description": "Start date for summary (Y-m-d, default: 30 days ago).", "disabled": false }, { "key": "date_to", "value": "2026-02-03", "description": "End date for summary (Y-m-d, default: today).", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/admin\/metrics\/summary?service_slug=revalidaciones&date_from=2026-01-04&date_to=2026-02-03" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieve aggregated summary statistics by service over a date range." }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": [\n {\n \"service_slug\": \"revalidaciones\",\n \"total_requests\": 37500,\n \"total_success\": 36000,\n \"total_failures\": 1500,\n \"avg_duration_ms\": 250.75\n }\n ]\n}", "name": "" } ] } ] }, { "name": "Admin - Tokens", "description": "\nAPIs for managing API tokens (issue, list, revoke).", "item": [ { "name": "List all tokens", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/tokens", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/tokens" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieve all API tokens with their associated clients, ordered by creation date (newest first)." }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": [\n {\n \"id\": 5,\n \"api_client_id\": 1,\n \"token\": \"gw_live_abc123...\",\n \"expires_at\": \"2027-02-03T12:00:00.000000Z\",\n \"last_used_at\": \"2026-02-03T11:30:00.000000Z\",\n \"revoked_at\": null,\n \"created_at\": \"2026-02-03T10:00:00.000000Z\",\n \"client\": {\n \"id\": 1,\n \"name\": \"Sistema Legacy A\",\n \"is_active\": true\n }\n }\n ]\n}", "name": "" } ] }, { "name": "Issue new token", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/tokens\/issue", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/tokens\/issue" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"api_client_id\":1,\"expires_in_days\":365}" }, "description": "Generate a new API token for a specific client. Token expiration defaults to 365 days if not specified." }, "response": [ { "header": [], "code": 201, "body": "{\n \"message\": \"Token issued successfully\",\n \"data\": {\n \"token\": \"gw_live_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz\",\n \"token_id\": 5,\n \"expires_at\": \"2027-02-03T12:00:00.000000Z\"\n }\n}", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"The api_client_id field is required.\",\n \"errors\": {\n \"api_client_id\": [\"The api_client_id field is required.\"]\n }\n}", "name": "" } ] }, { "name": "Revoke token", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/tokens\/:id\/revoke", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/tokens\/:id\/revoke", "variable": [ { "id": "id", "key": "id", "value": "5", "description": "Token ID." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Revoke an existing API token, preventing further use." }, "response": [ { "header": [], "code": 200, "body": "{\n \"message\": \"Token revoked successfully\"\n}", "name": "" }, { "header": [], "code": 404, "body": "{\n \"message\": \"Token not found\"\n}", "name": "" } ] } ] }, { "name": "Admin - API Clients", "description": "\nAPIs for managing API clients and their service permissions.", "item": [ { "name": "List all API clients", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/clients", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/clients" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieve all registered API clients with their token counts." }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Sistema Legacy Revalidaciones\",\n \"is_active\": true,\n \"allowed_service_slugs\": [\"revalidaciones\", \"detalle-contenedores\"],\n \"tokens_count\": 3,\n \"created_at\": \"2026-02-03T18:00:00.000000Z\",\n \"updated_at\": \"2026-02-03T18:00:00.000000Z\"\n }\n ]\n}", "name": "" } ] }, { "name": "Create new API client", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/clients", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/clients" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Sistema Legacy Producci\u00f3n\",\"is_active\":true,\"allowed_service_slugs\":[\"revalidaciones\"]}" }, "description": "Create a new API client with optional service restrictions." }, "response": [ { "header": [], "code": 201, "body": "{\n \"data\": {\n \"id\": 5,\n \"name\": \"Sistema Legacy Producci\u00f3n\",\n \"is_active\": true,\n \"allowed_service_slugs\": [\"revalidaciones\"],\n \"created_at\": \"2026-02-04T10:00:00.000000Z\",\n \"updated_at\": \"2026-02-04T10:00:00.000000Z\"\n }\n}", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"The name field is required.\",\n \"errors\": {\n \"name\": [\"The name field is required.\"]\n }\n}", "name": "" } ] }, { "name": "Get API client details", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/clients\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/clients\/:id", "variable": [ { "id": "id", "key": "id", "value": "1", "description": "Client ID." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Retrieve detailed information about a specific API client including active tokens." }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": {\n \"id\": 1,\n \"name\": \"Sistema Legacy Revalidaciones\",\n \"is_active\": true,\n \"allowed_service_slugs\": [\"revalidaciones\"],\n \"created_at\": \"2026-02-03T18:00:00.000000Z\",\n \"updated_at\": \"2026-02-03T18:00:00.000000Z\",\n \"tokens\": [\n {\n \"id\": 1,\n \"expires_at\": \"2027-02-03T18:00:00.000000Z\",\n \"last_used_at\": \"2026-02-04T09:30:00.000000Z\",\n \"revoked_at\": null,\n \"created_at\": \"2026-02-03T18:00:00.000000Z\"\n }\n ]\n }\n}", "name": "" }, { "header": [], "code": 404, "body": "{\n \"message\": \"No query results for model [App\\\\Models\\\\ApiClient] 999\"\n}", "name": "" } ] }, { "name": "Update API client", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/clients\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/clients\/:id", "variable": [ { "id": "id", "key": "id", "value": "1", "description": "Client ID." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Sistema Legacy Actualizado\",\"is_active\":false,\"allowed_service_slugs\":[\"revalidaciones\",\"detalle-contenedores\"]}" }, "description": "Update API client information and service permissions." }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": {\n \"id\": 1,\n \"name\": \"Sistema Legacy Actualizado\",\n \"is_active\": false,\n \"allowed_service_slugs\": [\"revalidaciones\", \"detalle-contenedores\"],\n \"updated_at\": \"2026-02-04T10:30:00.000000Z\"\n }\n}", "name": "" }, { "header": [], "code": 404, "body": "{\n \"message\": \"No query results for model [App\\\\Models\\\\ApiClient] 999\"\n}", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"The name field must be a string.\",\n \"errors\": {\n \"name\": [\"The name field must be a string.\"]\n }\n}", "name": "" } ] }, { "name": "Delete API client", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/clients\/:id", "query": [], "raw": "{{baseUrl}}\/api\/v1\/admin\/clients\/:id", "variable": [ { "id": "id", "key": "id", "value": "1", "description": "Client ID." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Delete an API client and revoke all associated tokens." }, "response": [ { "header": [], "code": 200, "body": "{\n \"message\": \"API Client deleted successfully. 3 tokens were revoked.\"\n}", "name": "" }, { "header": [], "code": 404, "body": "{\n \"message\": \"No query results for model [App\\\\Models\\\\ApiClient] 999\"\n}", "name": "" } ] } ] }, { "name": "Admin - Database Schema", "description": "\nAPIs for inspecting database schema to help create integration services.", "item": [ { "name": "List available tables", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/database\/tables", "query": [ { "key": "connection", "value": "target_db", "description": "Database connection name (source_db or target_db).", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/admin\/database\/tables?connection=target_db" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"connection\":\"architecto\"}" }, "description": "Get all tables available in the specified database connection." }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": [\n \"revalidaciones\",\n \"contenedores\",\n \"movimientos\"\n ]\n}", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"The connection field is required.\",\n \"errors\": {\n \"connection\": [\"The connection field is required.\"]\n }\n}", "name": "" } ] }, { "name": "Get table structure", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/admin\/database\/structure", "query": [ { "key": "connection", "value": "target_db", "description": "Database connection name (source_db or target_db).", "disabled": false }, { "key": "table", "value": "revalidaciones", "description": "Table name to inspect.", "disabled": false } ], "raw": "{{baseUrl}}\/api\/v1\/admin\/database\/structure?connection=target_db&table=revalidaciones" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"connection\":\"architecto\",\"table\":\"n\"}" }, "description": "Retrieve the column structure of a specific table to assist in creating validation rules and field mappings." }, "response": [ { "header": [], "code": 200, "body": "{\n \"data\": {\n \"table\": \"revalidaciones\",\n \"connection\": \"target_db\",\n \"columns\": [\n {\n \"name\": \"id\",\n \"type\": \"bigint\",\n \"nullable\": false,\n \"key\": \"PRI\",\n \"default\": null,\n \"extra\": \"auto_increment\"\n },\n {\n \"name\": \"referencia_id\",\n \"type\": \"int\",\n \"nullable\": false,\n \"key\": \"MUL\",\n \"default\": null,\n \"extra\": \"\"\n },\n {\n \"name\": \"fecha_evento\",\n \"type\": \"date\",\n \"nullable\": false,\n \"key\": \"\",\n \"default\": null,\n \"extra\": \"\"\n },\n {\n \"name\": \"contenedor\",\n \"type\": \"varchar(50)\",\n \"nullable\": false,\n \"key\": \"\",\n \"default\": null,\n \"extra\": \"\"\n },\n {\n \"name\": \"estatus\",\n \"type\": \"enum('pendiente','validado','rechazado')\",\n \"nullable\": false,\n \"key\": \"\",\n \"default\": null,\n \"extra\": \"\"\n },\n {\n \"name\": \"created_at\",\n \"type\": \"timestamp\",\n \"nullable\": true,\n \"key\": \"\",\n \"default\": null,\n \"extra\": \"\"\n }\n ],\n \"suggested_validation\": {\n \"referencia_id\": \"required|integer\",\n \"fecha_evento\": \"required|date\",\n \"contenedor\": \"required|string|max:50\",\n \"estatus\": \"required|string|in:pendiente,validado,rechazado\"\n },\n \"suggested_mapping\": {\n \"referencia_id\": \"referencia_id\",\n \"fecha_evento\": \"fecha_evento\",\n \"contenedor\": \"contenedor\",\n \"estatus\": \"estatus\"\n }\n }\n}", "name": "" }, { "header": [], "code": 404, "body": "{\n \"message\": \"Table not found\"\n}", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"Validation error\",\n \"errors\": {\n \"connection\": [\"The connection field is required.\"],\n \"table\": [\"The table field is required.\"]\n }\n}", "name": "" } ] } ] }, { "name": "Authentication", "description": "\nAPIs for SPA user authentication using Sanctum cookies.", "item": [ { "name": "Login", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/login", "query": [], "raw": "{{baseUrl}}\/api\/v1\/login" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"email\":\"admin@adtv.io\",\"password\":\"mufasa\",\"remember\":true}" }, "description": "Authenticate user with session cookie (SPA mode).\nRequires CSRF token from \/sanctum\/csrf-cookie first.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\n \"user\": {\n \"id\": 1,\n \"name\": \"Admin\",\n \"email\": \"admin@adtv.io\",\n \"email_verified_at\": \"2026-02-03T18:00:00.000000Z\",\n \"created_at\": \"2026-02-03T18:00:00.000000Z\",\n \"updated_at\": \"2026-02-03T18:00:00.000000Z\"\n }\n}", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"The provided credentials are incorrect.\",\n \"errors\": {\n \"email\": [\"The provided credentials are incorrect.\"]\n }\n}", "name": "" } ] }, { "name": "Logout", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/logout", "query": [], "raw": "{{baseUrl}}\/api\/v1\/logout" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Invalidate user session and cookie." }, "response": [ { "header": [], "code": 200, "body": "{\n \"message\": \"Logged out successfully\"\n}", "name": "" } ] }, { "name": "Get current user", "request": { "url": { "host": "{{baseUrl}}", "path": "api\/v1\/me", "query": [], "raw": "{{baseUrl}}\/api\/v1\/me" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Return the authenticated user's information." }, "response": [ { "header": [], "code": 200, "body": "{\n \"id\": 1,\n \"name\": \"Admin\",\n \"email\": \"admin@adtv.io\",\n \"email_verified_at\": \"2026-02-03T18:00:00.000000Z\",\n \"created_at\": \"2026-02-03T18:00:00.000000Z\",\n \"updated_at\": \"2026-02-03T18:00:00.000000Z\"\n}", "name": "" } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "Authorization", "type": "string" } ] } }