Authentication

Learn how to authenticate your requests to access the Wallaza API.

API Keys

All requests to the Wallaza API require authentication using an API key. Your API key should be included in the header of each request:

Authorization: Bearer YOUR_API_KEY

Getting an API Key

To get an API key:

  1. Create an account on our platform
  2. Navigate to your account settings
  3. Click on "API Keys" section
  4. Generate a new API key

API Key Security

Keep your API key secure and never share it publicly. If you believe your API key has been compromised, you should immediately:

  • Revoke the compromised key
  • Generate a new API key
  • Update your applications with the new key

Example Request

curl -X GET "https://api.wallaza.com/v1/wallpapers" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json"

Error Responses

If authentication fails, you'll receive one of these error responses:

{
    "error": "unauthorized",
    "message": "No API key provided",
    "status": 401
}

{
    "error": "forbidden",
    "message": "Invalid API key",
    "status": 403
}