FAQ

General

For the entities involved in the Energy sector and the public.

You will see also some APIs in some specific catalogs that are for EDP exclusive use.

You can add a user to your Developer Organization. In the Developer Portal, you click in your user name after login, go to "My organization" and click in "Add a user". The user should, of course, have an account created previously.

 

The new user, after login, will see two organizations, his initial own organization and the other one just added. In the other one, the new user will be able to see the Apps and all the information needed.

 

As an alternative, you can send an email to api.support@edp.com and mentioning you want to change the organization owner and we can assist you with that!

For now, we have only 4 catalogs. The 4 main catalogs are Public, Private, Internal and Web Services. If you are a developer outside EDP, you should look for the APIs in the Public catalog. If you are a partner, you should consume APIs on the Private catalog. If you are part of EDP, you should use the Internal catalog for REST Services and Web Services Catalog for SOAP services.

When logged in the portal, you can go to your user in the top right of the window, click on it and go to "my organization". In the "my organization" web page you can click in the button "Add a user" to add the user you want. Remember that the user should exist in the Portal already.

 

After that, the user will see both organizations, his/her own organization and the one you just added.

 

For any other issue, please reach us at api.support@edp.com

APIs

Please check Getting Started page for more details

A plan is a collection of API resources or subsets of resources from one or more APIs.

A plan can contain a mixture of HTTP GET, PUT, POST, and DELETE verbs from different APIs or it can contain all the GET verbs from various APIs.

A plan can have a common rate limit for all the resources or each resource can have a different rate limit. Rate limits specify how many requests an application can make during a specified time interval.

Use this Developer Portal to browse the different plans that are available to you and select a plan that is most suitable for your requirements. Some plans have restricted access that you must request access to use. When you submit your request, the organization is notified, the API administrator assesses your request and they might contact you for more details.

Other plans are available to use straight away.

First, you should be logged to the Developer Portal.

Later, go to the "Apps" menu and create an application. Right after, you will receive the client ID and client secret, save it!.

You must have this information when you call an API.

When you go to the step to subscribe to an API, or actually to a plan, you should choose the App you just created and start consuming it.

Your application client secret is stored encrypted, so we cannot retrieve the unencrypted version to tell you the value.

You can reset it, which will update the stored value and return the new value to you. You old value will automatically stop to work, so, be careful.

To do that click 'Apps' in the main menu, click on the application in question and then you can click the 'Reset' link in the 'Client Secret' section. Your new secret will be displayed at the top of the page.

Save it in a secure place for future use and so you don´t need to do that again.

It is possible to test an API directly from the Developer Portal. When looking at the details of an API you will see a table of the operations contained in the API.

The Developer Portal will show you all the methods available, GET, POST, DELETE, etc, and what are the paths to use.

If you click on the resource you will see more information about it, what parameters it might take, what it returns, what possible return codes it might use and what they mean. There is also a 'Try' button which enables you to try the resource out direct from the Developer Portal.

If you have any doubt or any feedback, please let us know.

Security

We use API keys for authorization, this is sent as a request header. You can find more details on the API definition.

Still need help?

Please contact us: api.support@edp.com