Skip to content

docs(samples): align crew list extraction contract - #17

Draft
grevgeny wants to merge 1 commit into
mainfrom
docs/crew-list-extraction-samples
Draft

docs(samples): align crew list extraction contract#17
grevgeny wants to merge 1 commit into
mainfrom
docs/crew-list-extraction-samples

Conversation

@grevgeny

@grevgeny grevgeny commented Aug 20, 2026

Copy link
Copy Markdown
Member

Summary

  • Add v1/crew-list-registrations to the generic data-extraction README, C# endpoint sample, and Postman collection.
  • Send both FromDateTime and ToDateTime when the ChkBox bridge requests a historical backfill.

Problem / Why

The public crew-list extraction endpoint was implemented and used by the dedicated ChkBox bridge, but it was absent from the generic public examples. The bridge also sent only FromDateTime for a backfill, while the API rejects one-sided historical ranges and requires both bounds.

Validation

  • dotnet restore Ditio.Samples.csproj — restored successfully; NuGet vulnerability-data cache access emitted NU1900 in the sandbox.
  • dotnet build Ditio.Samples.csproj --no-restore -nologo -clp:Summary -maxcpucount:1 /nr:false /p:UseSharedCompilation=false — passed, 0 errors (same NU1900 cache warning).
  • jq -e . postman/Ditio-Integration.postman_collection.json — passed.
  • git diff --check — passed.

Risk

Low. The endpoint inventory additions are documentation/sample-only. The request change makes the existing backfill path conform to the server's already-enforced date-range contract.

Notes

  • Coordinated partner documentation is being published in ditioas/timestyr.
  • ditioas/timestyr#4202 tracks separate server behavior for advertised ownership filtering and ordinary-user visibility; this PR does not change that behavior.
  • No open issue specifically tracks this recurring documentation-maintenance repair, so no issue was created or linked.
  • Keep this PR draft with ditioas/timestyr#4329: source review is clean, but the server documentation PR is blocked on unresolved integration-client access, project-filtering, and paging behavior.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant