You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
When retrieving an entity the "Format for URI" section specifies that the "key-entity-type" should be set to the alpha code value from the code list ENT. Therefore if following this exactly to create a URI to retrieve a manifest I would create:
/lcf/1.0/manifestation/{manifest-id}
This contains "manifestation" (singular)
There is then an example URI in the standard which is:
I think it would make more sense to always use plural and make it clear that the plural should always be used. This is because a RESTful URIs should be structured so each part is an element of the previous part.
In the retrieve, modify and delete URI examples the manifestation "1234567890" is an element of the "manifestations" collection.
In the retrieve list URI, the collection of "manifestations" is being retrieved
In the create URI a new manifest is being added to the "manifestations" collection
The text was updated successfully, but these errors were encountered:
The inconsistency was deliberate, but I do agree in retrospect that it is probably a mistake. We should discuss, but my hunch is that this should be consistently plural throughout.
Please check that all occurrences of entity types in the documentation for code list ENT and in the examples in the web service implementation documentation are now in the plural form.
When retrieving an entity the "Format for URI" section specifies that the "key-entity-type" should be set to the alpha code value from the code list ENT. Therefore if following this exactly to create a URI to retrieve a manifest I would create:
/lcf/1.0/manifestation/{manifest-id}
This contains "manifestation" (singular)
There is then an example URI in the standard which is:
GET http://192.168.0.99:80/lcf/1.0/manifestations/1234567890
This contains "manifestations" (plural)
The examples in the standard do not have consistent use of plural or singular
Retrieve: GET http://192.168.0.99:80/lcf/1.0/manifestations/1234567890 (plural)
Retrieve list: http://192.168.0.99:80/lcf/1.0/manifestations (plural)
Create: POST http://192.168.0.99:80/lcf/1.0/manifestation (singular)
Modify: PUT http://192.168.0.99:80/lcf/1.0/manifestation/1234567890 (singular)
Delete: DELETE http://192.168.0.99:80/lcf/1.0/manifestation/1234567890 (singular)
I think it would make more sense to always use plural and make it clear that the plural should always be used. This is because a RESTful URIs should be structured so each part is an element of the previous part.
In the retrieve, modify and delete URI examples the manifestation "1234567890" is an element of the "manifestations" collection.
In the retrieve list URI, the collection of "manifestations" is being retrieved
In the create URI a new manifest is being added to the "manifestations" collection
The text was updated successfully, but these errors were encountered: