api-guidelines icon indicating copy to clipboard operation
api-guidelines copied to clipboard

@nextLink vs. nextLink

Open erik-am opened this issue 7 years ago • 0 comments

Hi,

The guidelines describe that collections should have a @nextLink attribute.

However, in practice some Microsoft services use nextLink (without @). See https://azure.github.io/projects/apis/#!/DeploymentOperations/DeploymentOperations_List for example.

What is preferred? I can expect the @ can make it harder to work with the model in JavaScript or when (de)serializing in .NET.

erik-am avatar Nov 13 '17 08:11 erik-am