With Lumo's Public API, you can access your Lumo data from your own systems and tools and combine it with your own setup. For detailed implementation specifications, see the "API documentation" inside Lumo.
What the Public API Is
The Public API is a mechanism for programmatically retrieving your Lumo data from external systems and applications.
You can call your Lumo data from your own systems without using Lumo's web interface. By combining the data you have accumulated with your own analytics platforms and tools, you can automate and streamline your work.
This is a feature for engineers. Using it requires knowledge of building systems with APIs.
What You Can Do With the API
The current Public API lets you retrieve the history of LINE Chat conversations.
| What you can do | Details |
|---|---|
| Retrieve chat history | Retrieve the history of chats you exchanged with customers through your LINE Official Account, for a specified period |
By specifying the target LINE Official Account and the period to retrieve, you can pull out only the data you need. We plan to add more available features over time.
For the latest list of available features and detailed specifications, see the "API documentation" inside Lumo.
Getting Started
To use the Public API, you issue an API key and implement your system so that it can call your Lumo data.
An API key is the key Lumo uses to authenticate access from your system. You issue and manage API keys under API Keys in your workspace settings.
Issuing an API Key
You issue an API key in your workspace settings.
- Open Workspace Settings and select API Keys
- Click Issue API Key
- Copy the displayed API key and store it in a safe place
The API key is shown only once, at the time it is issued. Keep it in a safe place. It cannot be displayed again after you close the screen, so if you lose it, you will need to regenerate it.
Building It Into Your System
Using the API key you issued, implement your system so it can call your Lumo data.
For the specifications you need to implement it, such as how to build requests and the format of the data you can retrieve, see View API Documentation.
Managing API Keys
You can review and regenerate your issued API key under API Keys in your workspace settings.
| Action | Details |
|---|---|
| View and copy | Review your issued API key on screen and copy it |
| Regenerate | Disable your current API key and issue a new one |
Regenerating an API Key
If you lose your API key, or if there is a chance it has been exposed to a third party, regenerate it.
- Open API Keys in your workspace settings
- Click Regenerate
- Click Regenerate in the confirmation dialog
When you regenerate, the previous API key becomes invalid, and this action cannot be undone. After regenerating, be sure to set the new API key in your system again.
Using It Safely
An API key is a key that can access your Lumo data. Manage it carefully so it is not exposed to third parties.
- Do not share your API key with third parties
- Do not write your API key directly into source code or public repositories
- If there is a chance your API key has been leaked, regenerate it immediately
- The API has a limit on the number of requests per time period. If you exceed the limit, your requests will be temporarily restricted
For details on usage limits, such as the request limit, see the "API documentation" inside Lumo.
Frequently Asked Questions
Common questions about using the Public API are answered below.
I Lost My API Key
Because the API key is shown only once when it is issued, it cannot be displayed again. Regenerate it from API Keys in your workspace settings. After regenerating, you will need to set the new API key in your system again.
What Data Can I Retrieve?
Currently, you can retrieve the history of chats you exchanged with customers through your LINE Official Account, for a specified period. We plan to add more retrievable data over time.
Where Can I Find Details on How to Implement It?
From View API Documentation under API Keys in your workspace settings, you can find the specifications you need to implement it, such as how to build requests and the format of the data you can retrieve.