Neos API in rust

Featuring full serde support, time for datetimes, and strum for better enums.

Any official documentation of Neos' API is lacking, and the API is still changing too. So this crate can't guarantee correctness. Some of the types are based solely on educated guesses even.

This crate provides an example API client with the optional api_client feature.

Future plans

Better documentation in general
Splitting some linked Option<T> fields into their own sub-structs

Testing

The integration tests contact the live API. That's why they are ignored by default.

Some of them also require authentication.

Sadly not all the things can even be reliably tested without creating a mock API. Which in turn defeats the purpose of the tests in the first place.

Creating a user session manually

You can generate a user-sesion.json file with logging in via curl for example:

curl --request POST \
  --url https://cloudx.azurewebsites.net/api/userSessions \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
  "password": "pa$$word",
  "secretMachineId": "string",
  "rememberMe": true,
  "ownerId": "string",
  "email": "user@example.com",
  "username": "string"
}' > user-session.json

Only use a single identification method (username/email/ownerId). Also be sure to replace the rest of the values with your own. Using a secretMachineId is also recommended to not log out your other sessions. You can generate a random one for example with: openssl rand -hex 32

Running ignored tests

Make sure that you've got:

an internet connection
a valid user-sesion.json

Then just run the tests;

# A specific test with output logging
cargo test --all-features get_user -- --exact --ignored --nocapture
# All tests
cargo test --all-features -- --ignored

License