PWAs
GET https://alertopia.io/api/pwas/
curl --request GET \
--url 'https://alertopia.io/api/pwas/' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://alertopia.io/api/pwas/' \
--header 'Authorization: Bearer {api_key}' \
| Parámetros | Detalles | Descripción |
|---|---|---|
| search | Opcional Cadena | La cadena de búsqueda. |
| search_by | Opcional Cadena | ¿Por qué campo estás buscando? Los valores permitidos son: name. |
| datetime_field | Opcional Cadena | Valores permitidos: datetime, last_datetime |
| datetime_start | Opcional Cadena | Filter results starting from this datetime. Y-m-d H:i:s format. |
| datetime_end | Opcional Cadena | Filter results up to this datetime. Y-m-d H:i:s format. |
| order_by | Opcional Cadena | En qué campo ordenar los resultados. Los valores permitidos son: pwa_id, name, datetime, last_datetime. |
| order_type | Opcional Cadena | El orden de los resultados. Los valores permitidos son: ASC para orden ascendente, y DESC para orden descendente. |
| page | Opcional Entero | El número de página del que deseas obtener resultados. Por defecto es 1. |
| results_per_page | Opcional Entero | ¿Cuántos resultados deseas por página? Los valores permitidos son: 10, 25, 50, 100, 250, 500, 1000. El valor predeterminado es 25. |
{
"data": [
{
"id": 1,
"user_id": 1,
"name": "Example app",
"settings": {
"short_name": "Example",
"description": "Example PWA application.",
"start_url": "https://example.com/",
"display": "standalone",
"orientation": "any",
"background_color": "#ffffff",
"theme_color": "#237fff",
"app_icon_url": "https://example.com/icon.png",
"app_icon_maskable_url": "",
"mobile_screenshot_urls": ["", "", "", "", "", ""],
"desktop_screenshot_urls": ["", "", "", "", "", ""],
"shortcuts": [
{"name": "", "description": "", "url": "", "icon_url": ""},
{"name": "", "description": "", "url": "", "icon_url": ""},
{"name": "", "description": "", "url": "", "icon_url": ""}
],
"id": "",
"dir": "auto",
"lang": "en",
"scope_url": "https://example.com/"
},
"manifest": {
"name": "Example app",
"short_name": "Example",
"description": "Example PWA application.",
"start_url": "https://example.com/",
"display": "standalone",
"orientation": "any",
"background_color": "#ffffff",
"theme_color": "#237fff",
"lang": "en",
"dir": "auto",
"scope_url": "https://example.com/",
"icons": [
{
"src": "https://example.com/icon.png",
"type": "image/png",
"purpose": "any",
"sizes": "512x512"
}
]
},
"last_datetime": null,
"datetime": "2026-09-23 07:20:57"
}
],
"meta": {
"page": 1,
"results_per_page": 25,
"total_results": 1,
"total_pages": 1
},
"links": {
"first": "https://alertopia.io/api/pwas?page=1",
"last": "https://alertopia.io/api/pwas?page=1",
"next": null,
"prev": null,
"self": "https://alertopia.io/api/pwas?page=1"
}
}
GET https://alertopia.io/api/pwas/{pwa_id}
curl --request GET \
--url 'https://alertopia.io/api/pwas/{pwa_id}' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://alertopia.io/api/pwas/{pwa_id}' \
--header 'Authorization: Bearer {api_key}' \
{
"data": {
"id": 1,
"user_id": 1,
"name": "Example app",
"settings": {
"short_name": "Example",
"description": "Example PWA application.",
"start_url": "https://example.com/",
"display": "standalone",
"orientation": "any",
"background_color": "#ffffff",
"theme_color": "#237fff",
"app_icon_url": "https://example.com/icon.png",
"app_icon_maskable_url": "",
"mobile_screenshot_urls": ["", "", "", "", "", ""],
"desktop_screenshot_urls": ["", "", "", "", "", ""],
"shortcuts": [
{"name": "", "description": "", "url": "", "icon_url": ""},
{"name": "", "description": "", "url": "", "icon_url": ""},
{"name": "", "description": "", "url": "", "icon_url": ""}
],
"id": "",
"dir": "auto",
"lang": "en",
"scope_url": "https://example.com/"
},
"manifest": {
"name": "Example app",
"short_name": "Example",
"start_url": "https://example.com/",
"display": "standalone",
"icons": [
{
"src": "https://example.com/icon.png",
"type": "image/png",
"purpose": "any",
"sizes": "512x512"
}
]
},
"last_datetime": null,
"datetime": "2026-09-23 07:20:57"
}
}
POST https://alertopia.io/api/pwas
| Parámetros | Detalles | Descripción |
|---|---|---|
| name | Requerido Cadena | El nombre completo de tu aplicación PWA se mostrará en la pantalla de inicio de tu teléfono o en el escritorio. |
| short_name | Opcional Cadena | Nombre corto opcional de tu PWA, se mostrará cuando no haya suficiente espacio para mostrar el nombre completo. |
| description | Opcional Cadena | Descripción opcional corta de tu PWA: se mostrará en algunos dispositivos al instalar y después de la instalación. |
| start_url | Opcional Cadena | La URL completa que se abre cuando se inicia tu PWA. |
| background_color | Opcional Cadena | El color de fondo utilizado en la pantalla de presentación y mientras la aplicación se está cargando. |
| theme_color | Opcional Cadena | El color de la interfaz de usuario del navegador que coincide con el tema de tu aplicación. |
| app_icon_url | Requerido Cadena | El icono principal de tu aplicación. Asegúrate de que el icono sea de 512x512 píxeles, archivo PNG. |
| app_icon_maskable_url | Opcional Cadena | Asegúrate de que el icono sea de 512x512 píxeles, archivo PNG. ¿Qué es un icono adaptable? |
| mobile_screenshot_url_{1-6} | Opcional Cadena | Capturas de pantalla opcionales mostradas en el mensaje de instalación. |
| desktop_screenshot_url_{1-6} | Opcional Cadena | Capturas de pantalla opcionales mostradas en el cuadro de diálogo de instalación. |
| shortcut_name_{1-3} | Opcional Cadena | Nombre para el acceso directo tal como se muestra en el dispositivo. |
| shortcut_description_{1-3} | Opcional Cadena | Descripción opcional para explicar el atajo. |
| shortcut_url_{1-3} | Opcional Cadena | URL al que debería abrir el acceso directo. |
| shortcut_icon_url_{1-3} | Opcional Cadena | Asegúrate de que el icono sea de 128x128 píxeles, archivo PNG. |
| id | Opcional Cadena | Identificador único opcional para la PWA. Útil para actualizaciones y mantener la identidad en todas las instalaciones. |
| display | Opcional Cadena | Valores permitidos: fullscreen, standalone, minimal-ui, browser |
| orientation | Opcional Cadena | Valores permitidos: portrait, landscape, any |
| dir | Opcional Cadena | Valores permitidos: auto, ltr, rtl |
| lang | Opcional Cadena | en for Inglés, de for Alemán...etc. |
| scope_url | Opcional Cadena | Define el alcance de navegación de tu PWA. Solo las páginas dentro de este alcance serán accesibles mientras la aplicación esté en ejecución. Normalmente coincide con la ruta de la URL de inicio. |
curl --request POST \
--url 'https://alertopia.io/api/pwas' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example app' \
--form 'short_name=Example' \
--form 'description=Example PWA application.' \
--form 'start_url=https://example.com/' \
--form 'app_icon_url=https://example.com/icon.png' \
--form 'background_color=#ffffff' \
--form 'theme_color=#237fff' \
--form 'lang=en' \
--form 'scope_url=https://example.com/'
--url 'https://alertopia.io/api/pwas' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example app' \
--form 'short_name=Example' \
--form 'description=Example PWA application.' \
--form 'start_url=https://example.com/' \
--form 'app_icon_url=https://example.com/icon.png' \
--form 'background_color=#ffffff' \
--form 'theme_color=#237fff' \
--form 'lang=en' \
--form 'scope_url=https://example.com/'
{
"data": {
"id": 1,
"user_id": 1,
"name": "Example app",
"settings": {
"short_name": "Example",
"description": "Example PWA application.",
"start_url": "https://example.com/",
"display": "standalone",
"orientation": "any",
"background_color": "#ffffff",
"theme_color": "#237fff",
"app_icon_url": "https://example.com/icon.png",
"app_icon_maskable_url": "",
"mobile_screenshot_urls": ["", "", "", "", "", ""],
"desktop_screenshot_urls": ["", "", "", "", "", ""],
"shortcuts": [
{"name": "", "description": "", "url": "", "icon_url": ""},
{"name": "", "description": "", "url": "", "icon_url": ""},
{"name": "", "description": "", "url": "", "icon_url": ""}
],
"id": "",
"dir": "auto",
"lang": "en",
"scope_url": "https://example.com/"
},
"manifest": {
"name": "Example app",
"short_name": "Example",
"description": "Example PWA application.",
"start_url": "https://example.com/",
"display": "standalone",
"orientation": "any",
"background_color": "#ffffff",
"theme_color": "#237fff",
"lang": "en",
"dir": "auto",
"scope_url": "https://example.com/",
"icons": [
{
"src": "https://example.com/icon.png",
"type": "image/png",
"purpose": "any",
"sizes": "512x512"
}
]
},
"last_datetime": null,
"datetime": "2026-09-23 07:20:57"
}
}
POST https://alertopia.io/api/pwas/{pwa_id}
| Parámetros | Detalles | Descripción |
|---|---|---|
| name | Opcional Cadena | El nombre completo de tu aplicación PWA se mostrará en la pantalla de inicio de tu teléfono o en el escritorio. |
| short_name | Opcional Cadena | Nombre corto opcional de tu PWA, se mostrará cuando no haya suficiente espacio para mostrar el nombre completo. |
| description | Opcional Cadena | Descripción opcional corta de tu PWA: se mostrará en algunos dispositivos al instalar y después de la instalación. |
| start_url | Opcional Cadena | La URL completa que se abre cuando se inicia tu PWA. |
| background_color | Opcional Cadena | El color de fondo utilizado en la pantalla de presentación y mientras la aplicación se está cargando. |
| theme_color | Opcional Cadena | El color de la interfaz de usuario del navegador que coincide con el tema de tu aplicación. |
| app_icon_url | Opcional Cadena | El icono principal de tu aplicación. Asegúrate de que el icono sea de 512x512 píxeles, archivo PNG. |
| app_icon_maskable_url | Opcional Cadena | Asegúrate de que el icono sea de 512x512 píxeles, archivo PNG. ¿Qué es un icono adaptable? |
| mobile_screenshot_url_{1-6} | Opcional Cadena | Capturas de pantalla opcionales mostradas en el mensaje de instalación. |
| desktop_screenshot_url_{1-6} | Opcional Cadena | Capturas de pantalla opcionales mostradas en el cuadro de diálogo de instalación. |
| shortcut_name_{1-3} | Opcional Cadena | Nombre para el acceso directo tal como se muestra en el dispositivo. |
| shortcut_description_{1-3} | Opcional Cadena | Descripción opcional para explicar el atajo. |
| shortcut_url_{1-3} | Opcional Cadena | URL al que debería abrir el acceso directo. |
| shortcut_icon_url_{1-3} | Opcional Cadena | Asegúrate de que el icono sea de 128x128 píxeles, archivo PNG. |
| id | Opcional Cadena | Identificador único opcional para la PWA. Útil para actualizaciones y mantener la identidad en todas las instalaciones. |
| display | Opcional Cadena | Valores permitidos: fullscreen, standalone, minimal-ui, browser |
| orientation | Opcional Cadena | Valores permitidos: portrait, landscape, any |
| dir | Opcional Cadena | Valores permitidos: auto, ltr, rtl |
| lang | Opcional Cadena | en for Inglés, de for Alemán...etc. |
| scope_url | Opcional Cadena | Define el alcance de navegación de tu PWA. Solo las páginas dentro de este alcance serán accesibles mientras la aplicación esté en ejecución. Normalmente coincide con la ruta de la URL de inicio. |
curl --request POST \
--url 'https://alertopia.io/api/pwas/{pwa_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Updated example app' \
--form 'theme_color=#000000'
--url 'https://alertopia.io/api/pwas/{pwa_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Updated example app' \
--form 'theme_color=#000000'
{
"data": {
"id": 1,
"user_id": 1,
"name": "Updated example app",
"settings": {
"short_name": "Example",
"description": "Example PWA application.",
"start_url": "https://example.com/",
"display": "standalone",
"orientation": "any",
"background_color": "#ffffff",
"theme_color": "#000000",
"app_icon_url": "https://example.com/icon.png",
"app_icon_maskable_url": "",
"mobile_screenshot_urls": ["", "", "", "", "", ""],
"desktop_screenshot_urls": ["", "", "", "", "", ""],
"shortcuts": [
{"name": "", "description": "", "url": "", "icon_url": ""},
{"name": "", "description": "", "url": "", "icon_url": ""},
{"name": "", "description": "", "url": "", "icon_url": ""}
],
"id": "",
"dir": "auto",
"lang": "en",
"scope_url": "https://example.com/"
},
"manifest": {
"name": "Updated example app",
"short_name": "Example",
"start_url": "https://example.com/",
"display": "standalone",
"theme_color": "#000000",
"icons": [
{
"src": "https://example.com/icon.png",
"type": "image/png",
"purpose": "any",
"sizes": "512x512"
}
]
},
"last_datetime": "2026-09-23 07:20:57",
"datetime": "2026-09-23 07:20:57"
}
}
DELETE https://alertopia.io/api/pwas/{pwa_id}
curl --request DELETE \
--url 'https://alertopia.io/api/pwas/{pwa_id}' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://alertopia.io/api/pwas/{pwa_id}' \
--header 'Authorization: Bearer {api_key}' \