Frequenty Asked Questions

Some shorter questions regarding Mashape's platform have been grouped below.


Table of Contents

  1. Can I delete an API that I have added in Mashape? the Unirest library
  2. Where can I control notifications in Mashape?
  3. What API communication and data interchange protocols does Mashape support?
  4. Do I need to install/deploy any packages to my server to use Mashape as a provider?
  5. How can I email / send a message to all my API subscribers?
  6. Will I get charged for using my paid API in Mashape?
  7. Where can I check usage information of my API?
  8. What is the difference between a Testing Key and a Production Key?
  9. Will I get charged for a paid API while using a test key?
  10. What is a Mashape authorization key?
  11. What does Mashape offer for taking a 20% revenue share with an API provider?
  12. Why should I add pricing in Mashape if I already have one on my own?

1. Can I delete an API that I have added in Mashape?

Nope, not currently. If you set your API to private no one, but you and the people you invite manually to see it, will.

2. Where can I control notifications in Mashape?

Mashape sends out notifications to developers and API providers to alert them of important activities that require attention. If you want to turn on/off these notifications, please go to Account Settings -> Notifications

Notification Tab Fig. 1 Notification tab

3. What API communication and data interchange protocols does Mashape support?

Mashape supports RESTful APIs. RESTful APIs use HTTP requests to post, read, and delete data e.g. CRUD operations (Create, Read, Update, Delete). Mashape specifically supports:

  • POST
  • PUT
  • PATCH
  • DELETE
  • GET

For data interchange, Mashape supports String, Binary, and JSON payloads.

4. Do I need to install/deploy any packages to my server to use Mashape as a provider?

As Mashape is a cloud service, you don't need to install anything on your server.

Mashape is a proxy layer between you (API provider) and the developer.

5. How can I email / send a message to all my API subscribers?

You can't send a message to all your API subscribers in Mashape. Instead we've simplified this process: Now to email all your subscribers simply hit "Announcement" tab In your API page!

6. Will I get charged for using my paid API in Mashape?

No, as long as you're using the same Mashape account that created the API, you will not be charged to consume your API.

However, you need to subscribe to one of your paid plans. If you don't subscribe to a plan the following error message will be displayed:

"Before consuming the API, you must subscribe to one of its plans..."

7. Where can I check usage information of my API?

To see who's using your API and the number of API calls they're making, log in into your account and go to the API profile, then click "Analytics and Settings" on the right hand side.

Once the page has loaded you can find API specific analytics.

8. What is the difference between a Testing Key and a Production Key?

Although the Testing Key provides the easiest and fastest way to test APIs in Mashape, it is also the least secure. If someone gets hold of your Testing Key, he/she will be able to access all the Mashape APIs that you have access to, including the paid APIs.

The Production Key allows you to generate and re-generate keys for a single or group of APIs that you consume. This makes Production Keys a more secure way of consuming APIs in Mashape. You can easily re-generate these keys if it gets compromised.

9. Will I get charged for a paid API while using a test key?

Yes. The Testing key provides convenience by giving you access to all APIs in Mashape. It has the same access as the Production keys you generate. As such, it is subject to the same billing parameters of a paid API.

10. What is a Mashape authorization key?

To authenticate your application with Mashape, you are required to pass a Mashape key in an API call header.

Each account comes by default with a "Default Application", each application is a box that can contain APIs that you wish to consume together or separately.

Each Application also comes with a pair of Mashape keys.

  • Testing Key
  • Production Key

These keys are used to authenticate your requests when consuming APIs. Treat them as your passwords. If a malicious users gets ahold of your keys he/she could perform requests on your behalf, You can imagine how annoying that could be for you.

You can view keys in the Mashape dashboard, after clicking on your Application. By default this is "Default Application". Just click "Get the Keys" to display them. More importantly, be aware that you can re-generate Mashape keys in the eventuality they might have been compromised.

11. What does Mashape offer for taking a 20% revenue share with an API provider?

Mashape offers a ton of services for API providers and developers. They are outlined below:

Instant Distribution

Once you’ve published a public API it becomes available to thousands of active developers. You can also add a private API and work collaboratively inside your organization.

Fast API Doc Editor

Easily create or edit your private or public documentation, enabling developers to quickly understand and consume your API. We’re your one-stop-shop for API docs.

Community Generated Issues

Create, comment, and follow an API issue to report bugs or malfunctions. Our users are contributing to the fastest growing and most trusted API community.

API Monetization

Offer public or private billing options. You determine all pricing parameters, such as calls or unique objects; as well as the ability to create multiple plans and feature sets.

API Status and Notification

Easily view the status of an API, including its average latency and uptime percentage. We send notifications of issues and performance updates.

Administrative Analytics

Everyone needs data. We’ll show you the number of API calls, the adoption rate of developers utilizing your API, and the amount of errors.

In addition, by listing your API on Mashape you'll be part of the coolest API community in the world!

12. Why should I add pricing in Mashape if I already have one on my own?

There are certain advantages to setting up billing/pricing in Mashape.

You have direct access to Mashape's developer community. A significant number of our developers have credit cards on file and ready to purchase your API.

Instead of requiring a developer to get a separate API key, they can immediately try out your API through the Mashape test console.

It will also help promote your API to developers in different channels. Some examples: