- Log in to the API Publisher as a user who has the creator role assigned. For more information on creating users and assigning roles, refer to section
Once logged in, select the Add menu to. The Add New API window opens.
We explain each field of the above window using a sample phone validation service. This service is exposed by Cdyne company, has SOAP and REST interfaces and is documented using a WSDL file. This service is described at :
The table below explains the fields and sample values according to the phone validation service. Only the fields marked with * are
Field Description Example Values Name* Name of API as you want it to appear in the API store. PhoneVerification Context* URI context path that is used by to API consumers. /phoneverify Version* API version (in the form of version.major.minor). 1.0.0 Description High-level description of API functionality. Text Visibility Anchor APIVisibility APIVisibility
API visibility can be either Public or Restricted. If it is set to Public, the API is visible through the API Store Web application to all API subscribers and also anonymous users of the API store.Alternatively, it can be set to Restricted and specific user roles that have access to the API through the API Store can be set as a comma-separated list (no spaces) in the 'Visible to Roles' text box that appears. Note: If you specify "subscriber" role here, any user who self-subscribes to the API Store will be able to access the API, since users are assigned the "subscriber" role that comes by default with the WSO2 API Manager when they sign-up to the API StoreFor details, see API Visibility.
Public Thumbnail Image
Icon to be displayed in API store (can be jpeg, tiff, png format).
Image file Endpoint Type*
Secured endpoint or Non secured endpoint. Default is non secured endpoint.
If secured endpoint is selected, user will be asked for credentials of the backend service.
Secured Production URL* Endpoint of the back-end service URL, here:
URL Credentials If secured endpoint is selected as the "Endpoint Type" above, user will be asked for credentials of the backend service. Sandbox URL
Endpoint of sandbox (testing) back-end service.
A sandbox URL is meant to be used for online testing of an API with easy access to an API key.
URL WSDL URL of WSDL file (describing API interface):
URL WADL URL to WADL file (describing API interface). URL
Any number of tags separated by comma. Tags allow you to group/categorize APIs that have similar attributes and behaviors. When tagging, always use relevant keywords and common search terms. Once a tagged API gets
Anchor tier tier For details, see API-Level Throttling.
Business Owner and Email
Information about the person responsible for this API at a business level.
Technical Owner and Email
Information about the person responsible for this API at a technical level.
String Anchor resource resource For details, see API Resources. Info title Note
When the user tries to send requests to a secured endpoint, s/he might get a
Hostname verfiication failedexception. To overcome this, set
AllowAllin <APIM_HOME>/repository/conf/axis2/axis2.xml file's HTTPS transport sender configuration. For example,
This parameter is used to verifies the hostname of the certificate of a server when API Manager acts as a client and does outbound service calls.
- Once the required information is filled, click the Create button at the end of the page to create the API.
- If the API is created successfully, the All APIs window opens with the newly-added API. For example,
- Click the API to access its information. The following tabs are available:
- Overview: Displays the details of the API.
- Edit: Allows the user to change the API details and test the Endpoint URL, Sandbox URL, WSDL and WADL.
- Versions: Shows usage and subscription statistics of the API per version.
- Docs: Allows to add documents to an API. For instructions, refer to section
- Users: Shows the list of active users subscribed to the API and their subscription statistics.
Info title Note
The Edit tab is only visible to users with creator privileges. Users logged in as creators do not have permission to publish the API. To publish, you need to log in as a user with publisher privileges.