Planet Mado API Documentation

Overview
The Planet Mado NPC Chat System provides an API for programmatically creating NPC chat sessions.

This API allows game directors and third-party applications to generate one-time chat session links for players to interact with NPCs. The API is RESTful and uses JSON for request and response payloads.

Important: Keep your API key secure. Do not expose it in client-side code or public repositories.

Authentication
How to authenticate your API requests

All API requests must include an API key in the Authorization header using the Bearer token format.

Authorization Header
Authorization: Bearer your-api-key-here

Obtaining an API Key

API keys are managed by the Planet Mado system administrator. Contact them to request an API key for your application.

API Key Security Best Practices

  • Store your API key in environment variables, never in your source code
  • Do not expose your API key in client-side JavaScript
  • Implement proper access controls for your API key
  • Rotate your API key periodically
  • Use HTTPS for all API requests