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

[AIP-136] Spec should clarify an exception to the verb in the HTTP URI #1376

Open
xyziemba opened this issue Jul 4, 2024 · 0 comments
Open

Comments

@xyziemba
Copy link

xyziemba commented Jul 4, 2024

General guidance in AIP-136 states that:

The HTTP URI must use a : character followed by the custom verb (:archive in the above example), and the verb in the URI must match the verb in the name of the RPC.

However, there's an exception in the Stateless methods section:

The URI should place both the verb and noun after the : separator (avoid a "faux collection key" in the URI in this case, as there is no collection). For example, :translateText is preferable to text:translate.

This exception, allowing verb and noun, is easy to miss. It would be helpful to update the general guidance with a phrase like "... except for stateless methods as defined in this AIP."

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

No branches or pull requests

1 participant