give downloaders more hints to find the guestbookId #12001

Author: pdurbin

doc/sphinx-guides/source/api/changelog.rst

@@ -9,7 +9,7 @@ This API changelog is experimental and we would love feedback on its usefulness.
 
 v6.10
 -----
-- The following GET APIs will now return ``400`` if a required Guestbook Response is not supplied. A Guestbook Response can be passed to these APIs in the JSON body using a POST call.
+- The following GET APIs will now return ``400`` if a required Guestbook Response is not supplied. A Guestbook Response can be passed to these APIs in the JSON body using a POST call. See the notes under :ref:`basic-file-access` and :ref:`download-by-dataset-by-version` for details.
 
   - **/api/access/datafile/{fileId:.+}**
 
@@ -19,7 +19,7 @@ v6.10
 
   - **/api/access/dataset/{id}/versions/{versionId}**
 
-- The following POST APIs will now return ``400`` if a required Guestbook Response is not supplied. A Guestbook Response can be passed to these APIs in the JSON body.
+- The following POST APIs will now return ``400`` if a required Guestbook Response is not supplied. A Guestbook Response can be passed to these APIs in the JSON body. See the note under :ref:`basic-download-by-dataset` for details.
 
   - **/api/access/datafiles**
 

doc/sphinx-guides/source/api/dataaccess.rst

@@ -27,6 +27,8 @@ Please note that in addition to the files from dataset, an additional file call
 
 There are two forms of the "download by dataset" API, a basic form and one that supports dataset versions.
 
+.. _basic-download-by-dataset:
+
 Basic Download By Dataset
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -50,6 +52,8 @@ The fully expanded example above (without environment variables) looks like this
 
   curl -L -O -J -H X-Dataverse-key:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx https://demo.dataverse.org/api/access/dataset/:persistentId/?persistentId=doi:10.70122/FK2/N2XGBJ
 
+.. _download-by-dataset-by-version:
+
 Download By Dataset By Version
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -82,6 +86,8 @@ The fully expanded example above (without environment variables) looks like this
 
   curl -O -J -H X-Dataverse-key:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx https://demo.dataverse.org/api/access/dataset/:persistentId/versions/2.0?persistentId=doi:10.70122/FK2/N2XGBJ
 
+.. _basic-file-access:
+
 Basic File Access
 -----------------