Platform tour

This section provides an insight into the basics of Mindee UI. It describes all the features and its function.

API Hub

When you create an account at Mindee, you'll land on the APIs Hub. There are two sections on this page: The Off-the-shelf APIs in the APIs store and Your APIs which are off-the-shelf APIs currently in use and custom generated APIs.

To use an API, click on the corresponding API card you want from the API store. If you can't find what you're looking for in the off-the-shelf API Store, you can build it yourself by clicking on the Create a new API button. Follow this tutorial to guide you through the process of creating your own API.

API Filtering by Location

You can filter your off-the-shelf APIs in the APIs store by location; this makes it easier to find the APIs you wish to use. However, regardless of your location, you will be able have access to all available off-the-shelf APIs.

Some of the APIs listed are relevant only to a certain location; for example, the French ID card API won't be that relevant to someone in the United States unless there is a specific need for it.

Here are the region specific off-the-shelf APIs currently available:

Globally

• Invoice OCR API.
• Receipt OCR API.
• Passport OCR API.

Europe

• License Plates

France

These are not documented yet (working on it), but if you use any other off-the-shelf API, you should be able to use them without any issues. If you need any help, feel free to ask on our Slack community

• Carte Nationale d'Identité.
• Carte Vitale.

Note: You can use all these available off-the-shelf API no matter your location.

API - Dashboard

From the dashboard, you can monitor and manage your usage and your plan. The dashboard has two main sections:

• API usage section
• API metrics section

API Usage

You can view your current monthly plan and usage under the API usage. The default subscription is a free plan that renews automatically each month. To customize your subscription, click on the Go unlimited button. If your plan is active, it will be automatically renewed each month.

API Metrics

In the API Metrics section you can view your:

• Traffic: Number of inputs processed (images and pdf pages).
• Errors: Number of HTTP errors.
• Latency: Average server-side computation time in milliseconds.

API - Documentation

Whether it's an off-the-shelf API from the API Store or a custom-built API, you can access the specific documentation to help you test and integrate easily. The documentation has different sections which are:

• API Reference
• Response scheme
• Limitations
• Open API

API Reference

From the API reference section you can view:

• HTTP Request: This contains all the main information you need to make a request to your API, such as base URL, Content-type, Authentication headers, and form data.
• Sample code: This contains ready to use sample codes in different languages which you can copy and paste in your environment.

Response scheme

From the Response scheme section you can view:

• Response structure: This contains a full JSON response example along with a few details about how to access your document level predictions.
• Extracted fields: This provides details about every field extracted by the API within a document.

Limitations

From the limitations section you can view:

• Supported documents: This contains details on the type of documents you can send to the API for parsing.
• Rate limits: This provides information on the rate limits of each API depending on your plan.

Open API

The OpenAPI section is a swagger-like user interface that allows you to navigate through your API technical information. You can also download the OpenAPI definition of your API.

API - API Keys

With the API keys section, you can create numerous API keys according to your needs, retrieve, and delete your API keys. Follow these steps listed here to create an API key.

To delete an API key:

1. Click on the trash icon located on the left.
   
2. A dialog box will pop out, type the name of your API key and click on the Delete API button.

Note: It is important to note that if you delete your API keys, it cannot be revoked.

API - Live interface

This is your home for no code testing. In our graphical user interface, you can drag and drop your documents to see the API in action. You can also see all of the extracted information, as well as the raw API JSON response in one location. For custom-built APIs, a trained model is required before the live interface can be used.

API - Models

This section is only available for custom APIs built using the API Builder. You can monitor the status of your training in real time, informing you when it is in progress, deployed, or canceled.

API - Training

This section is only available for custom APIs built using the API Builder. In this section, you can train your custom-built API by annotating data. The left part of the Training interface is the viewer. You can drag and drop single documents or archives you want to annotate. The right part of the screen is your data model. Each field you've set up in your data model appears here.

API - Settings

This section is only available for custom APIs built using the API Builder. In this section, you can modify the metadata about your API. In the Actions section, you can also:

• Download your training data: An email with your training data (raw files and annotations) will be sent to you and your account admins.
• Download your data model config: It's the json formatted data model of your API. Downloading this configuration file will help you duplicate your API if you want to create a similar one.
• Delete your API: You can delete your API, along with all its training data. This action is permanent and cannot be undone.

 

Questions?
  Join our Slack