Martindale App API / API de la app de Martindale
This bilingual resident communication app is a community resource, not the official city website. For official transactions, forms, payments, records, and authoritative information, use the official City of Martindale website.
Esta app bilingüe de comunicación para residentes es un recurso comunitario, no el sitio web oficial de la ciudad. Para trámites, formularios, pagos, registros e información autorizada, use el sitio web oficial de la Ciudad de Martindale.
Usage / Uso
This is a discovery and operation reference, not a complete submission payload specification. Use the resident forms for submissions and consent. Do not send personal information without permission, generate installation metrics, or trigger restricted jobs. Access controls remain in effect. For replay-safe submissions, reuse the same UUID Idempotency-Key only for retries with unchanged details. Honor HTTP 429 and Retry-After; never retry side effects blindly.
Esta es una referencia de descubrimiento y operaciones, no una especificación completa de los datos de envío. Use los formularios para los envíos y el consentimiento. No envíe información personal sin permiso, genere métricas de instalación ni active tareas restringidas. Los controles de acceso siguen vigentes. Para envíos seguros ante reintentos, reutilice el mismo UUID en Idempotency-Key solo al reintentar sin cambiar los datos. Respete HTTP 429 y Retry-After; no repita acciones a ciegas.
Local weather / Tiempo local
GET /api/weather
GET returns National Weather Service data for Martindale as { ok, weather }. Upstream outages return 503.
GET devuelve datos del Servicio Meteorológico Nacional para Martindale como { ok, weather }. Las fallas del proveedor devuelven 503.
Map address lookup / Búsqueda de direcciones
GET /api/reverse-geocode
GET requires lat and lng; lang may be en or es. Returns { address }, which may be null. Limited to 30 requests per 10 minutes per client. Invalid coordinates return 400; provider failures return 502.
GET requiere lat y lng; lang puede ser en o es. Devuelve { address }, que puede ser null. Límite de 30 solicitudes por cliente cada 10 minutos. Las coordenadas inválidas devuelven 400; las fallas del proveedor devuelven 502.
Map reports / Reportes del mapa
GET / POST /api/map-feedback
GET returns approved public reports, with optional west, south, east, north bounds (supply all four), cursor, and report identifier. Pages contain at most 200 reports. POST submits a resident report and requires a UUID Idempotency-Key in production. Use the resident form for consent and validation.
GET devuelve reportes públicos aprobados, con límites opcionales west, south, east, north (incluya los cuatro), cursor e identificador report. Cada página contiene hasta 200 reportes. POST envía un reporte y requiere un UUID en Idempotency-Key en producción. Use el formulario para el consentimiento y la validación.
Report a map concern / Reportar un problema del mapa
POST /api/map-feedback/abuse
POST requests review of an approved public map report. JSON requires reportId (UUID) and reason (privacy, impersonation, incorrect, unsafe, or other); details and contactEmail are optional. A UUID Idempotency-Key is required. Limited to five new concerns per hour per client.
POST solicita revisar un reporte público aprobado. El JSON requiere reportId (UUID) y reason (privacy, impersonation, incorrect, unsafe u other); details y contactEmail son opcionales. Se requiere un UUID en Idempotency-Key. Límite de cinco solicitudes nuevas por cliente por hora.
Questions and ideas / Preguntas e ideas
POST /api/community-input
POST submits a resident question or idea. A UUID Idempotency-Key is required in production. Use the resident form for consent and validation. The receipt includes id, notificationStatus, and replayed; acceptance does not guarantee notification delivery.
POST envía una pregunta o idea de un residente. Se requiere un UUID en Idempotency-Key en producción. Use el formulario para el consentimiento y la validación. El recibo incluye id, notificationStatus y replayed; la aceptación no garantiza la entrega de la notificación.
Email alert subscriptions / Suscripciones a alertas por correo
GET / POST / PUT / DELETE /api/alert-signups
POST requests an email subscription with a UUID Idempotency-Key; confirmation is required. GET reads preferences using a management session or an emailed management token with email. PUT changes topics and locale; DELETE unsubscribes. Production changes require the short-lived HttpOnly management cookie obtained through an emailed link. Use the alerts page; never subscribe another person without consent.
POST solicita una suscripción por correo con un UUID en Idempotency-Key; se requiere confirmación. GET consulta preferencias con una sesión de gestión o un token de gestión enviado por correo junto con email. PUT cambia topics y locale; DELETE cancela la suscripción. Los cambios en producción requieren la cookie HttpOnly de gestión obtenida desde un enlace por correo. Use la página de alertas; nunca suscriba a otra persona sin su consentimiento.
Email confirmation links / Enlaces de confirmación por correo
GET / POST /api/alert-signups/link
GET displays a confirmation page without applying the action. POST accepts application/x-www-form-urlencoded fields purpose (confirm, manage, unsubscribe), token, and optional locale, then redirects with 303. Tokens come only from subscriber emails. Do not automatically follow or submit confirmation actions.
GET muestra una página de confirmación sin aplicar la acción. POST acepta campos application/x-www-form-urlencoded: purpose (confirm, manage, unsubscribe), token y locale opcional; después redirige con 303. Los tokens provienen únicamente de correos para suscriptores. No siga ni envíe automáticamente acciones de confirmación.
Browser notifications / Notificaciones del navegador
GET / POST / PUT / DELETE /api/push-subscriptions
GET returns configured and, when available, publicKey. POST saves a browser push subscription after user permission. PUT checks subscription state and DELETE removes it; both accept JSON with an HTTPS endpoint. Use the alerts page to manage browser permission and topics. Changes are rate limited.
GET devuelve configured y, cuando está disponible, publicKey. POST guarda una suscripción push con permiso del usuario. PUT consulta su estado y DELETE la elimina; ambos aceptan JSON con un endpoint HTTPS. Use la página de alertas para gestionar permisos y temas. Los cambios tienen límites de frecuencia.
App installation events / Eventos de instalación
POST /api/pwa-installs
POST records an observed app installation without a request body. Intended for the app's installation event handler, not synthetic traffic. Limited to 25 requests per client per day.
POST registra una instalación observada sin cuerpo de solicitud. Está destinado al controlador de instalación de la app, no al tráfico sintético. Límite de 25 solicitudes por cliente al día.
Published attachments / Archivos adjuntos publicados
GET /api/content-files/{id}
GET downloads a published attachment by id, using its stored media type. Obtain identifiers from published app content. Missing files return 404 and unavailable storage returns 503. The catalog anchor is the API base; an id is required to download a file.
GET descarga un archivo adjunto publicado por id con su tipo de contenido almacenado. Obtenga los identificadores del contenido publicado de la app. Los archivos ausentes devuelven 404 y el almacenamiento no disponible devuelve 503. El anchor del catálogo es la base de la API; se requiere un id para descargar.
Event calendar download / Descarga de eventos del calendario
GET /calendar.ics
GET downloads one published event as text/calendar. Requires event; locale may be en or es. Unknown or missing events return 404. Obtain event identifiers from the app calendar.
GET descarga un evento publicado como text/calendar. Requiere event; locale puede ser en o es. Los eventos desconocidos o ausentes devuelven 404. Obtenga los identificadores desde el calendario de la app.
Operational health (restricted) / Estado operativo (restringido)
GET /api/health/operational
GET requires an operator's bearer credential. Returns status, checks, and metrics; degraded service returns 503. Not an anonymous public health endpoint.
GET requiere una credencial bearer de operador. Devuelve status, checks y metrics; un servicio degradado devuelve 503. No es un endpoint de estado público anónimo.
Notification dispatch (restricted) / Envío de notificaciones (restringido)
GET /api/cron/outbox
GET is an operator-only scheduled job requiring a cron bearer credential. It dispatches queued notifications and has side effects. Do not crawl or invoke automatically; incomplete dispatch returns 503.
GET es una tarea programada exclusiva para operadores que requiere una credencial bearer de cron. Envía notificaciones pendientes y modifica el estado. No rastree ni invoque automáticamente; un envío incompleto devuelve 503.
Data retention (restricted) / Retención de datos (restringido)
GET /api/cron/retention
GET is an operator-only scheduled job requiring a cron bearer credential. It applies the configured retention policy, using dry-run mode unless deletion is approved. It can delete data. Do not crawl or invoke automatically.
GET es una tarea programada exclusiva para operadores que requiere una credencial bearer de cron. Aplica la política de retención en modo de simulación, salvo que se apruebe la eliminación. Puede eliminar datos. No rastree ni invoque automáticamente.
Email provider webhook (restricted) / Webhook del proveedor de correo (restringido)
POST /api/webhooks/resend
POST is reserved for Resend delivery events. Requires the original signed payload and svix-id, svix-timestamp, and svix-signature headers. Invalid signatures return 400. Not a general submission endpoint.
POST está reservado para eventos de entrega de Resend. Requiere el contenido original firmado y los encabezados svix-id, svix-timestamp y svix-signature. Las firmas inválidas devuelven 400. No es un endpoint de envío general.