Skip to main content

API Token Generation

1

Access Server Settings

Navigate to your server’s settings page in the Melonly dashboard.
2

Open Panel Section

Click on “Panel” in the server settings navigation.
3

Locate API Tokens

Scroll down to the “Server API Tokens” section.
4

Create New Token

  • Click the token creation button
  • Enter a descriptive name for identification
  • Set an appropriate expiry date for your use case
  • Generate the token
5

Secure Your Token

Copy immediately: The token is only displayed once and cannot be retrieved after this step.
Copy and store your API token in a secure location.

Verify Integration

Test your newly created token with a server information request:
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.melonly.xyz/api/v1/server/info

Expected Response

{
  "id": "server_12345",
  "name": "Your Server Name",
  "discordGuildId": "987654321098765432",
  "ownerId": "owner_67890",
  "createdAt": 1640995200,
  "joinCode": "ABC123"
}

Security Considerations

  • Rotation: Implement regular token rotation schedules
  • Scope: Use separate tokens for different applications or environments
  • Storage: Never commit tokens to version control or expose in client-side code
  • Monitoring: Track token usage and implement alerting for unusual activity
API tokens inherit the permissions of the creating user. Ensure your account has the necessary server access levels for your intended API operations.

What’s Next?

Start with read-only endpoints like /server/info and /server/members to familiarize yourself with the API structure before implementing write operations.