Authentication

The MagicSlides API uses access ID-based authentication. Every request to the API must include your unique access ID.

Getting Your Access ID

You can find your access ID in your MagicSlides dashboard under API Settings. If you haven't generated an access ID yet, you'll need to create one first.

Using Your Access ID

Include your access ID in the request body of every API call using the accessId parameter.

Example Request

{
  "topic": "Artificial Intelligence",
  "email": "your-email@example.com",
  "accessId": "your-access-id-here"  // Include your access ID here
}

Security Best Practices

Keep your access ID secure and never share it publicly
Rotate your access ID periodically for enhanced security
Use environment variables to store your access ID in your applications
Monitor your API usage regularly for any unauthorized access

Error Handling

If authentication fails, the API will return a 401 Unauthorized response:

{
  "success": false,
  "error": "Invalid access ID provided",
  "code": "AUTH_ERROR"
}