Skip to content

Conversation

hellais
Copy link
Member

@hellais hellais commented Feb 18, 2025

WIP specification update for OONI Run v2.1

implements ooni/backend#930

Question: do we want to use headers for this or should we instead make a
new post handler which does these in the request body? That would be
slightly more flexible if we would like to use this request to pass
additional data as part of the first request.
Copy link

@sdsantos sdsantos left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This look to be breaking changes to the schema. Should the endpoints become .../api/v2.1/...?

@hellais hellais marked this pull request as ready for review May 5, 2025 11:14
@hellais
Copy link
Member Author

hellais commented May 5, 2025

This look to be breaking changes to the schema. Should the endpoints become .../api/v2.1/...?

The concern here is that inputs might be empty and the clients are not able to read the targets and targets_name

Fix syntax of targets
@hellais
Copy link
Member Author

hellais commented May 15, 2025

I think I have come up with a better solution to handle older clients in: 6f70178.

Basically we don't need to have a new key, but instead we just handle extra metadata for inputs through inputs_extra. That way if clients don't understand inputs_extra, they will still be able to read inputs like normal.

It also should make the implementation easier and not have to handle multiple different cases depending on client support.

hellais and others added 5 commits June 2, 2025 15:45
* Drop targets and replace with `inputs_extra`
* Cleanup some text
- Move fields from headers to body
- Move fields from query parameters to body 
- Mark fields for dynamic test lists calculation as required
@hellais hellais requested review from LDiazN, aanorbel and sdsantos June 2, 2025 14:11
Copy link
Member Author

@hellais hellais left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For me this is good to go. Once @LDiazN marks it as approved, we can merge it. 🐳

Copy link
Contributor

@LDiazN LDiazN left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved!

@hellais hellais merged commit bedd76b into master Jun 2, 2025
@hellais hellais deleted the oonirun-v2.1 branch June 2, 2025 14:23
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.

4 participants