An open API service indexing awesome lists of open source software.

https://github.com/4turesearchdata-carpentries/webapi4rdm

This repository contain information about a workshop on the API of 4TU.ResearchData for Research Data Management support staff.
https://github.com/4turesearchdata-carpentries/webapi4rdm

4turesearchdata api fetching-data-from-an-api upload-datasets

Last synced: 2 months ago
JSON representation

This repository contain information about a workshop on the API of 4TU.ResearchData for Research Data Management support staff.

Awesome Lists containing this project

README

          

# How RDM support staff can use the API of 4TU.ResearchData

Welcome to the **4TU.ResearchData API for Data supporters** workshop!

[![schema.org Course](https://img.shields.io/badge/schema--org-Course-blue.svg)](./schema-course.jsonld)

## πŸš€ Workshop Overview

The idea of this workshop is to familiarize them with the main endpoints of the WebAPI for requesting, downloading, searching, and uploading datasets and software to the 4TU.ResearchData repository. The main target audience is the RDM support staff from the Dutch technical universities

The proposed schedule for a 3-hour session is:

Introduction (10 minutes)

Hands-on practice with the endpoints in the terminal (up to 2 hours, including one break)

Discussion and troubleshooting: time for questions and for addressing projects, issues, or challenges participants may already have within their faculties (1 hour)

## πŸ“… Schedule

Main topics:
- Fetching datasets, software, collections
- Searching and fetching data from authors
- Searching accounts within your institution
- Uploading
- Metadata uploading
- File uploading
- Submit for review
- Image preview

## πŸ›  Prerequisites
Before attending the workshop, please ensure you have:

- (Required) Two private tokens in data.4tu.nl (main enviroment) and in next.data.4tu.nl (test environment)
- The `yq` a command-line YAML processor (similar syntax to `jq`).
- Linux
```bash
sudo apt-get update
sudo apt install yq
```
- macOS
```bash
brew install yq
```
- Windows (in powershell)

```bash
scoop install yq
```
or
```bash
choco install yq
```

- (Optional but nice to have) The `jq` program to render nicely json outputs:
- Linux
```bash
sudo apt-get update
sudo apt-get install -y jq
```
- macOS
```bash
brew install jq
```
- Windows
- If you’re using Git Bash or WSL, use the Linux instructions above.
- Otherwise, download the executable from the jq releases page (https://jqlang.org/download/) and add it to your PATH.

## πŸ’‘ License
This workshop material is licensed under **GNU AFFERO GENERAL PUBLIC LICENSE Version 3**. Feel free to share and modify the lesson according your needs.

--------------------------

Happy coding! πŸŽ‰