API Dictionary

From Golden Retriever Wiki

Revision as of 16:03, 22 December 2023 by Dave (talk | contribs) (Created page with "This endpoint is used to list of all the dictionaries tied to your account along with their unique "Dictionary_no", which you will need as the {id} for using the Data endpoint. '''curl -X GET -H "Content-Type: application/json" -H "authorization: <api_key>" "https://api.thedog.io/dictionary"''' Each response from the API will be in the following JSON format: '''{ "message": "Successful", "skip": 0, "limit": 10, "total": 15, "data": [] }''' "message" will ei...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This endpoint is used to list of all the dictionaries tied to your account along with their unique "Dictionary_no", which you will need as the {id} for using the Data endpoint.

curl -X GET -H "Content-Type: application/json" -H "authorization: <api_key>" "https://api.thedog.io/dictionary"

Each response from the API will be in the following JSON format:

{

 "message": "Successful",
 "skip": 0,
 "limit": 10,
 "total": 15,
 "data": []

}

"message" will either be "Successful" or an error message. "skip" is how many records into the query we skipped, "limit" is how many objects we returned. "total" is the total amount of objects that are available. And "data" is an array of objects containing the results.

By default, the results will be paginated in pages of 10 results. To change the amount of results per page (the limit) or the amount of records to skip (the skip) you would add additional URL parameters, beginning with a $ (or %24 when URL encoded)

curl -X GET -H "Content-Type: application/json" -H "authorization: <api_key>" "https://api.thedog.io/dictionary?$limit=2&$skip=6" or curl -X GET -H "Content-Type: application/json" -H "authorization: <api_key>" "https://api.thedog.io/dictionary?%24limit=2&%24skip=6"

This will grab two records starting on the 7th record.

You can also sort the records by one of the field names by using the following format:

$sort[CreatedOn]=asc (or when URL encoded: %24sort%5BCreatedOn%5D=asc)

curl -X GET -H "Content-Type: application/json" -H "authorization: <api_key>" "https://api.thedog.io/dictionary?$sort[CreatedOn]=asc" or curl -X GET -H "Content-Type: application/json" -H "authorization: <api_key>" "https://api.thedog.io/dictionary?%24sort%5BCreatedOn%5D=asc"

You can either use "asc" or "desc" for the direction of the sort.

Once you have the Dictionary_no you want to pull the data from you can use the Data endpoint to pull the data