[Feature Request] API call to create a trip

[monora]

I already succeeded to import trips from a file using the rails runner (see script below). An API call would be a much better solution.

Proposal for the api call (copied from the create area call). The call should return the ID of the new trip:

  "/api/v1/trips":
    post:
      summary: Creates a trip
      tags:
      - Trips
      parameters:
      - name: api_key
        in: query
        required: true
        description: API Key
        schema:
          type: string
      responses:
        '201':
          description: trip created
          content:
            application/json:
              schema:
                type: number
                properties:
                  id:
                    type: integer
                    example: 14
                    description: The ID of trip created
        '422':
          description: invalid request
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  example: One week in London
                  description: The name of the trip
                description:
                  type: string
                  example: Visited my friend in England
                  description: The name of the trip
                start_at:
                  type: date-time
                  example: '2023-01-01'
                  description: The start time of the trip
                end_at:
                  type: date-time
                  example: '2023-01-07'
                  description: The start time of the trip
              required:
              - name
              - start_at
              - end_at
            examples:
              '0':
                summary: Creates a trip
                value:
                  name: One week in London
                  start_at: '2023-01-01'
                  end_at: '2023-01-07'

Example script to create trips from a csv file:

# Zähler für erfolgreiche und fehlgeschlagene Importe
success_count = 0
failure_count = 0

# CSV-Datei lesen
CSV.foreach(csv_file_path, headers: true, encoding: 'UTF-8') do |row|
  name = row['title']
  started_at = row['start_date']
  ended_at = row['end_date']

  # Konvertiere Datum in das richtige Format
  begin
    started_at = Time.zone.parse(started_at)
    ended_at = Time.zone.parse(ended_at)
  rescue ArgumentError => e
    puts "Fehler beim Parsen der Daten für Trip '#{name}': #{e.message}"
    failure_count += 1
    next
  end

  # Erstelle und speichere den Trip
  trip = Trip.new(
    name: name,
    started_at: started_at,
    ended_at: ended_at,
    user_id: user_id
  )

  if trip.save
    success_count += 1
    puts "Trip '#{name}' erfolgreich gespeichert."
  else
    failure_count += 1
    puts "Fehler beim Speichern des Trips '#{name}': #{trip.errors.full_messages.join(', ')}"
  end
end

puts "Import abgeschlossen: #{success_count} erfolgreich, #{failure_count} fehlgeschlagen."