17 unstable releases (6 breaking)

0.6.0 Sep 24, 2024
0.4.0 Apr 16, 2023
0.2.1 Mar 3, 2023
0.0.0-alpha.1 Nov 2, 2022

#196 in Game dev

Download history 18/week @ 2024-07-01 81/week @ 2024-07-29 7/week @ 2024-08-05 367/week @ 2024-09-23 33/week @ 2024-09-30

400 downloads per month
Used in 5 crates (4 directly)

MPL-2.0 license

72KB
1.5K SLoC

ChilloutVR API in rust

License Crates.io Docs

A rust crate for ChilloutVR's API.

This is fully unofficial and in no way affiliated, endorsed, supported, or created by Alpha Blend Interactive, the creators of ChilloutVR.

The crate has models of the responses, with proper serde support. It also definitions for the requests, using racal for the HTTP parts and big request/response structs for WebSockets, meaning that there's no lock-in to a single API client. An example API client using reqwest is provided for convenience though.

The API technically isn't public yet, so proceed with your own discretion. That also means there is no official API documentation. Which means it's possible that some things are wrong and/or will change a lot in the future.

Testing

The integration tests contact the live API. While a mock API could be created, it'd defeat the purpose of the tests. Which is to see that the client can actually use the real current API. While the requests & responses could be saved for a mock API, ensuring it stays up to date and behaves exactly like the real one is infeasible.

The integration tests are ignored by default for this reason. A lot of the tests also require actual authentication with an account, which you can read more about below.

Creating a user session manually

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

curl --request POST \
  --url https://api.abinteractive.net/1/users/auth \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
  "username": "email@Address",
  "password": "pa$$word",
  "authType": "LoginCredentials"
}' > user-auth.json

The resulting file should look something like the following:

{
 "message": "Successfully logged in as ljoonal",
 "data": {
  "username": "ljoonal",
  "accessKey": "long-string",
  "userId": "uuid",
  "more fields...": "...and their values"
 }
}

Running live API tests

Make sure that you've got an internet connection & a valid user-auth.json.

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

License

Note that the license is MPL-2.0 instead of the more common MIT OR Apache-2.0. A license change however can be negotiated if the ABI team wants to use this crate or adopt this crate into a more official one with a different license.

Dependencies

~2–16MB
~218K SLoC