mein-plakat API (1.0.0)

Retrieves all API permissions (scopes) from all resource servers in Auth0.

Creates a new permission (scope) on a resource server.

Deletes a permission (scope) from a resource server.

Redirects the user to the Auth0 Universal Login page.

Logs the user out via Auth0.

Handles the callback from Auth0, exchanges code for tokens, and redirects back to the app.

Returns the user profile information contained in the access token.

Exchanges a refresh token for a new access token.

Synchronizes Auth0 user data to the local database after login. Called from frontend after successful authentication.

Retrieves all users from Auth0 with local database data. Admin permission required.

Retrieves a single user from Auth0 with roles, permissions, and local data.

Updates a user in Auth0 and local database. Admin permission required.

Deletes a user from Auth0 and local database. Admin permission required.

Retrieves all roles from Auth0. Admin permission required.

Creates a new role in Auth0. Admin permission required.

Retrieves a single role from Auth0 with its permissions.

Updates a role in Auth0, including name, description, and assigned permissions.

Deletes a role from Auth0. Admin permission required.

Returns total Auth0 user count. Cached 1 hour. Admin permission required.

Returns AWS Cost Explorer data (current month costs, estimated month-end, past 12 months). Cached for 1 hour. Admin permission required.

Returns all MongoDB collections with document count. Admin permission required.

Returns paginated documents from a collection. Supports search. Admin permission required.

Creates an async export job. Returns immediately with jobId. SIS process-exports task picks up pending jobs and generates the file. Admin permission required.

Execute GraphQL queries and mutations against the mein-plakat API.

Available Queries:

• checkPermissions - Check if current user has admin permissions
• locationPhotos(page, limit, districtId, providerId) - Get location photos with pagination
• locationPhoto(id) - Get a single location photo by ID
• consumerMarketPhotos(page, limit, consumerMarketId, providerId) - Get consumer market photos with pagination
• consumerMarketPhoto(id) - Get a single consumer market photo by ID
• logs(page, limit, app, level) - Get logs with pagination
• sdawBaseRecords(type, page, limit) - Get SDAW base records (filtered by type)
• sdawBaseRecord(id, type) - Get a single SDAW base record
• sdawDetailRecords(baseId, type, collectionSuffix, page, limit) - Get SDAW detail metadata (actual data from S3 via REST)
• importStats - Get overall import statistics
• users(page, limit, sortBy, sortOrder) - Get users with pagination
• receivedEmails(page, limit, sortBy, sortOrder) - Get received emails with pagination
• sentEmails(page, limit, sortBy, sortOrder) - Get sent emails with pagination

Example Query:

query {
  locationPhotos(page: 1, limit: 10) {
    items {
      _id
      districtId
      providerId
      originalPath
      variants { size type path }
    }
    pageInfo { total hasNextPage }
  }
}

Returns pre-computed location coverage statistics (tiles, fiscal year data). Admin permission required.

Returns paginated list of locations missing data for a given coverage metric. Admin permission required.

Extracts column headers from uploaded Excel file for mapping (admin only).

Imports municipality directory data from Excel file with field mapping (admin only).

Generates a temporary CloudFront signed URL for a private file (admin only).

Extracts column headers from uploaded schedule file for mapping. Admin permission required.

Imports schedule (Terminplan) data from Excel/CSV with field mapping. Replaces only business years present in file. Admin permission required.

Imports SDAW records from a file (text content).

Returns all attachments for a given email template (admin only).

Uploads a file attachment for an email template. The file is stored in S3 and metadata is saved in the template document (admin only).

Deletes a file attachment from an email template. Removes the file from S3 and the metadata from the template document (admin only).

Returns the health status of the API service

Returns detailed information for an advertising location identified by its slug. Includes free booking terms from all business years (filtered to dates >= today), image variants, and core location data.

Alternative to slug lookup. Returns the same location details (free terms, image info) when identified by providerId, locationNumber, and positionNumber. IDs are parsed as integers.

Returns filter options for objectTypes and illuminations. No authentication required. Used by the Site app for dynamic filter loading.

Returns the full decoded SDAW JSON for a given file UUID. The UUID corresponds to the S3 key sdaw/{uuid}.json.

Creates a ticket in the Simple Support System (project mein_plakat).

Retrieves the profile of the currently logged-in user.

Updates the profile of the currently logged-in user.

Sends a password reset email to the logged-in user.

Uploads a profile picture for the logged-in user (Multipart/form-data).

Retrieves the entire watchlist for the currently logged-in user.

Adds a location to the user's watchlist.

Removes a location from the user's watchlist.

Checks if a specific location is in the user's watchlist.