API de AppConsol

Devuelve el usuario dueño del token, sus scopes, restricciones y fecha de expiración. Úsalo para validar la configuración.

Scope: ninguno (cualquier token válido)

curl https://www.appconsol.com/api/v1/me \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

{
  "data": {
    "user": { "id": "66f1...", "email": "dev@ejemplo.com", "name": "Dev" },
    "token": {
      "id": "66f2...",
      "name": "CI deploy",
      "prefix": "acp_Ab12Cd",
      "scopes": ["apps:read", "resources:read", "resources:write"],
      "appIds": [],
      "expiresAt": "2026-12-29T18:00:00.000Z"
    },
    "rateLimit": { "requestsPerMinute": 120 }
  }
}

Lista las aplicaciones accesibles por el token (todas, o solo las permitidas si el token está restringido).

Scope: apps:read

curl https://www.appconsol.com/api/v1/apps \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

{
  "data": [
    {
      "id": "66f1c0a2b7e4d91a2c3f4e59",
      "name": "Mi App",
      "description": "App de notas",
      "subdomain": "app-mi-app",
      "url": "https://app-mi-app.appconsol.com",
      "dataDeletionEnabled": true,
      "dataDeletionUrl": "https://app-mi-app.appconsol.com/data-deletion-request",
      "iconUrl": null,
      "featureGraphicUrl": null,
      "resourceCount": 4,
      "createdAt": "2026-09-30T18:00:00.000Z"
    }
  ]
}

Crea una aplicación. Por defecto incluye política de privacidad, términos, robots.txt y app-ads.txt a partir de plantillas.

Scope: apps:write

• No disponible para tokens restringidos a aplicaciones específicas (403 token_restricted).
• Límite: 20 creaciones por hora y 100 aplicaciones por cuenta.

curl -X POST https://www.appconsol.com/api/v1/apps \
  -H "Authorization: Bearer $APPCONSOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi App",
    "subdomain": "mi-app",
    "description": "App de notas",
    "dataDeletionEnabled": true
  }'

201 Created · { "data": { ...app, "resources": [ ... ] } }

Detalle de una aplicación, incluyendo el listado de recursos (sin contenido).

Scope: apps:read

curl https://www.appconsol.com/api/v1/apps/$APP_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

Modifica campos de la aplicación. Solo se actualizan los campos enviados.

Scope: apps:write

curl -X PATCH https://www.appconsol.com/api/v1/apps/$APP_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "description": "Nueva descripción", "dataDeletionEnabled": false }'

Elimina la aplicación, todos sus recursos y sus solicitudes de eliminación de datos. Irreversible.

Scope: apps:delete

curl -X DELETE https://www.appconsol.com/api/v1/apps/$APP_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

204 No Content

Lista los recursos de la app.

Scope: resources:read

curl "https://www.appconsol.com/api/v1/apps/$APP_ID/resources?type=html&include=content" \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

Crea un recurso nuevo y lo publica inmediatamente en su ruta.

Scope: resources:write

curl -X POST https://www.appconsol.com/api/v1/apps/$APP_ID/resources \
  -H "Authorization: Bearer $APPCONSOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "soporte.html",
    "type": "html",
    "path": "/soporte.html",
    "content": "<h1>Soporte</h1><p>Escríbenos a soporte@ejemplo.com</p>"
  }'

201 Created
{
  "data": {
    "id": "66f1c0a2b7e4d91a2c3f4e5a",
    "name": "privacy-policy",
    "type": "privacy-policy",
    "path": "/privacy-policy",
    "url": "https://app-mi-app.appconsol.com/privacy-policy",
    "contentLength": 5120,
    "lastUpdated": "2026-09-30T18:20:00.000Z",
    "content": "<!DOCTYPE html>..."
  }
}

Obtiene un recurso con su contenido completo.

Scope: resources:read

curl https://www.appconsol.com/api/v1/apps/$APP_ID/resources/$RESOURCE_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

Modifica un recurso. Solo se actualizan los campos enviados y lastUpdated se renueva.

Scope: resources:write

curl -X PATCH https://www.appconsol.com/api/v1/apps/$APP_ID/resources/$RESOURCE_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "content": "<h1>Soporte</h1><p>Nuevo horario</p>" }'

Elimina el recurso; su URL pública deja de responder.

Scope: resources:delete

curl -X DELETE https://www.appconsol.com/api/v1/apps/$APP_ID/resources/$RESOURCE_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

204 No Content

Lista las políticas (privacidad y términos) de la app.

Scope: resources:read

curl https://www.appconsol.com/api/v1/apps/$APP_ID/policies \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

Agrega una política a la app.

Scope: resources:writeai:generate (solo source=ai)

• source=template genera un HTML profesional con el nombre de tu app.
• source=ai redacta la política con IA (límite 10 por hora) y requiere además el scope ai:generate.
• source=custom publica exactamente el contenido que envíes.
• Si ya existe un recurso en la ruta, responde 409: usa PATCH para modificarla.

curl -X POST https://www.appconsol.com/api/v1/apps/$APP_ID/policies \
  -H "Authorization: Bearer $APPCONSOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "privacy-policy",
    "source": "template",
    "contactEmail": "privacidad@ejemplo.com"
  }'

201 Created · { "data": { ...recurso, "source": "template" } }

Obtiene una política con su contenido.

Scope: resources:read

curl https://www.appconsol.com/api/v1/apps/$APP_ID/policies/$POLICY_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

Modifica una política (contenido, nombre, ruta o tipo entre privacy-policy y terms).

Scope: resources:write

curl -X PATCH https://www.appconsol.com/api/v1/apps/$APP_ID/policies/$POLICY_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{ "content": "<!DOCTYPE html><html><body><h1>Política de privacidad</h1>...</body></html>" }
JSON

Elimina la política.

Scope: resources:delete

curl -X DELETE https://www.appconsol.com/api/v1/apps/$APP_ID/policies/$POLICY_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

204 No Content

Lista solicitudes (más recientes primero, sin captura de pantalla) con paginación por cursor.

Scope: data_deletion:read

curl "https://www.appconsol.com/api/v1/apps/$APP_ID/data-deletion-requests?status=pending&limit=20" \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

{
  "data": [
    {
      "id": "66f3...",
      "appId": "66f1...",
      "username": "juan",
      "email": "juan@correo.com",
      "status": "pending",
      "createdAt": "2026-09-29T10:00:00.000Z"
    }
  ],
  "pagination": { "hasMore": false, "nextCursor": null }
}

Detalle de una solicitud, incluida la captura de pantalla (data URL).

Scope: data_deletion:read

curl https://www.appconsol.com/api/v1/apps/$APP_ID/data-deletion-requests/$REQUEST_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

Cambia el estado de la solicitud.

Scope: data_deletion:write

curl -X PATCH https://www.appconsol.com/api/v1/apps/$APP_ID/data-deletion-requests/$REQUEST_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "status": "processed" }'

Elimina la solicitud definitivamente.

Scope: data_deletion:write

curl -X DELETE https://www.appconsol.com/api/v1/apps/$APP_ID/data-deletion-requests/$REQUEST_ID \
  -H "Authorization: Bearer $APPCONSOL_TOKEN"

204 No Content