Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remote API documentation #15

Merged
merged 32 commits into from
Jul 9, 2023
Merged

Remote API documentation #15

merged 32 commits into from
Jul 9, 2023

Conversation

real2two
Copy link
Contributor

@real2two real2two commented Jun 13, 2023

Remote API documentation

I decided start documenting Pterodactyl Panel's remote API routes.

Quick side note: I might be missing some optional parameters Pterodactyl Panel sends to Wings on my documentation, but I didn't include them because Wings never uses them.

Todo

  • Explain headers in README.md.
  • Replace 'example body's with actual example values, instead of the type.
  • Responses, including errors.
  • Provide example response models. Example response models #9 (edit: besides one route I couldn't figure out.)

This was referenced Jun 13, 2023
@devnote-dev
Copy link
Owner

Please mark the PR as a draft then update it when it's ready for review.

@devnote-dev devnote-dev added enhancement New feature or request coverage This covers undocumented APIs labels Jun 13, 2023
@real2two real2two marked this pull request as draft June 13, 2023 01:09
@real2two
Copy link
Contributor Author

real2two commented Jun 14, 2023

I'm going to note that I might be missing some optional parameters/body on some routes. I'll try to fix anything I can find, but I can't guarantee anything.

@devnote-dev
Copy link
Owner

That's fine, when it's ready for review I'll go through the whole API.

@real2two
Copy link
Contributor Author

I couldn't find this remote API route in Pterodactyl Panel's develop branch, which is pretty interesting.

POST /servers/:server/archive - The function's name is "SetArchiveStatus".
https://github.com/pterodactyl/wings/blob/bd26d6eefddcdbdc14779ae61b1ff126820241da/remote/servers.go#L104

@real2two
Copy link
Contributor Author

real2two commented Jun 15, 2023

I gave up response examples for GET /api/remote/backups/:backup, because I couldn't figure out how to get S3 to properly work on Pterodactyl Panel.

I decided to leave the response example as "WIP.", but everything else is complete, unless there are any small issues I need to change.

@real2two real2two marked this pull request as ready for review June 15, 2023 02:24
@NaysKutzu

This comment was marked as off-topic.

pterodactyl/remote/server_backups.md Outdated Show resolved Hide resolved
pterodactyl/remote/server_backups.md Outdated Show resolved Hide resolved
pterodactyl/remote/server_backups.md Outdated Show resolved Hide resolved
pterodactyl/remote/server_backups.md Outdated Show resolved Hide resolved
pterodactyl/remote/server_installation.md Outdated Show resolved Hide resolved
pterodactyl/remote/servers.md Outdated Show resolved Hide resolved
pterodactyl/remote/sftp.md Outdated Show resolved Hide resolved
pterodactyl/remote/sftp.md Outdated Show resolved Hide resolved
@real2two
Copy link
Contributor Author

real2two commented Jun 28, 2023

Please read this:

  • I placed events in activity_events.md. I didn't provide any descriptions for each event.
  • I have no idea what data.parts[].etag and data.parts[].part_number does in POST /api/remote/backups/:backup, so I added "???" as a placeholder description, so you might want to check that out.

@real2two real2two requested a review from devnote-dev July 8, 2023 22:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
coverage This covers undocumented APIs enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants