Biomech

Ingest Sessions

Changed on

Ingest biomech sessions, pitches, and frames.

Idempotency: when source_pitch_id is present, pitch_uuid is derived from the player, session, and source_pitch_id only; pitch_index is a display sequence. The default sync_mode=snapshot removes pitches/frames omitted from a re-upload.

post/api/v1/biomech/sessions

Request

  • Base URL
    https://developer.preciser.io
  • URL
    https://developer.preciser.io/api/v1/biomech/sessions
  • Auth
    none declared. Required headers: x-api-key, League

Headers

x-api-keystring required

Required API key issued by Preciser.

Leaguestring required

Required tenant/database selector, for example pitchbio-master.

Request body

sync_mode'snapshot' | 'upsert'

snapshot treats every submitted session as complete and removes omitted pitches/frames. upsert keeps omitted rows.

Response

Successful Response

successboolean required
sessions_upsertedinteger required
pitches_upsertedinteger required
frames_upsertedinteger required

Changes

  • 9b0abde08b06Revision changes
    • breaking

      the header request parameter League became required

    • breaking

      the header request parameter x-api-key became required

    • breaking

      header request parameter League list-of-types was narrowed by removing types null

    • breaking

      header request parameter x-api-key list-of-types was narrowed by removing types null

    • info

      added the new optional request property

    • info

      for the header request parameter League, the type was generalized from no type to string

    • info

      for the header request parameter x-api-key, the type was generalized from no type to string