Full API documentation

MGRAM's full technical documentation is at api.mgram.biz. The Knowledge Base explains scenarios, and the reference covers every method.

What the docs include

• Quick start for bots and for bot factories: which key you need and where to begin.
• Reference of all methods with parameters and responses, searchable by path or name.
• Code examples: pick a method and a language to get ready code and a sample response.
• Errors: one format and what to fix for each HTTP code.
• Webhook check: send a test event to your address right from the docs page.

General API rules

• Plain HTTPS requests with JSON — no SDK needed.
• The base URL is https://api.mgram.biz.
• The key goes in the Authorization: Bearer KEY header.
• A webhook must be a public HTTPS address and reply 200 or 204. The signature is an HMAC-SHA256 of timestamp.body in the X-MGRAM-Signature header.

Types of keys

Overview by scenario

• Tasks API — monetizing a bot with tasks.
• Bot statistics and management API — bot data and settings.
• Partner API — for bot factories.