Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify trips and status changes response behavior #563

Merged
merged 1 commit into from
Nov 18, 2020

Commits on Nov 5, 2020

  1. Clarify trips and status changes response behavior

    In MDS 0.4.x we request trips and status changes for a given hour.
    A provider may have no data to report for the requested hour
    multiple reasons, including:
    
    - The hour has not yet fully passed
    - The provider was not operational in the region during the hour
    - The provider has not yet completed processing that hour's data
    - No trips or events occurred during the hour
    
    Differentiating the last two reasons is particularly important because
    it lets consumers of APIs know whether or not they need to re-request
    the hour at a later time. A successful 200 response with an empty
    list of data clearly communicates that the provider has nothing to
    report for that hour and that it's not necessary to try again later.
    Having this behavior consistent across providers would help us at
    Populus spend less time requesting data and reduce the number of
    requests received by providers.
    jiffyclub committed Nov 5, 2020
    Configuration menu
    Copy the full SHA
    b07bb80 View commit details
    Browse the repository at this point in the history