Store APIs

The following Store APIs are deprecated and will be unsupported in a future release. They are provided below for reference by existing users. For a complete list of the currently supported Store APIs, go to https://docs.wso2.com/display/AM210/apidocs/store/.

Note: When you access any API other than the login and logout APIs through an external REST client such as cURL, first invoke the login API to ensure that user is authenticated. When the login API is invoked, the system stores the generated session cookie in a file, which we use in the next API invocations.

The responses is a JSON message.

Login

Description	Log in to API Store.
URI	http://localhost:9763/store/site/blocks/user/login/ajax/login.jag
URI Parameters	`action=login&username=<username>&password=<password>`
HTTP Methods	POST
Example	`curl -X POST -c cookies http://localhost:9763/store/site/blocks/user/login/ajax/login.jag -d 'action=login&username=admin&password=admin'`

Logout

Description	Log out from API Store.
URI	http://localhost:9763/store/site/blocks/user/login/ajax/login.jag?action=logout
URI Parameters	`?action=logout`
HTTP Methods	GET
Example	`curl -b cookies http://localhost:9763/store/site/blocks/user/login/ajax/login.jag?action=logout`

User Signup

Description	Add a new API Consumer.
URI	http://localhost:9763/store/site/blocks/user/sign-up/ajax/user-add.jag
URI Parameters	`action=addUser&username=<username>&password=<password>&allFieldsValues=<first_name>\|<last_name>\|<organization>\|<address>\|<country>\|<email>\|<land>\|<mobile>\|<IM>\|<url>`
HTTP Methods	POST
Example	`curl '`http://localhost:9763/store/site/blocks/user/sign-up/ajax/user-add.jag'`-H 'Accept: application/json --data 'action=addUser&kimhill=username&password=kimhill1234&allFieldsValues=Kim\|Hill\|ABC Network\|30 Palm Road ,Pasadena,California\|USA\|kim@abcnetwork.com\|0016269934122\|0016269934134\|kimhill\|www.abcNsounds.org/'`

Search APIs

Description	Search for APIs using a given query.
URI	http://localhost:9763/store/site/blocks/search/api-search/ajax/search.jag
URI Parameters	`action=searchAPIs&query=<query>&start=<number>&end=<number>` The `start` and `end` parameters determine the range of APIs you want to retrieve. For example, if start=1 and end=3, the first 3 APIs that appear in the search results will be returned. Note that both 0 and 1 represent the first API in the search results, so start=0 and start=1 both means the same.
HTTP Methods	POST
Example	`curl -X POST -b cookies "http://localhost:9763/store/site/blocks/search/api-search/ajax/search.jag" -d "action=searchAPIs&query=test&start=0&end=3"`

Get all Paginated Published APIs

Description	Get a list of all published APIs in paginated form so that browsing is easier.
URI	http://localhost:9763/store/site/blocks/api/listing/ajax/list.jag
URI Parameters	action=getAllPaginatedPublishedAPIs, tenant, start, end, returnAPITags (optional) The `start` and `end` parameters determine the range of APIs you want to retrieve. For example, if start=1 and end=10, the first 10 APIs that appear in the API Store will be returned. The `returnAPITags` parameter is optional. If `returnAPITags=true`, the system makes a call to the registry and returns the tags of each API in the response.
HTTP Methods	GET
Example	To get the first 100 APIs in the API Store: `curl -b cookies "http://localhost:9763/store/site/blocks/api/listing/ajax/list.jag?action=getAllPaginatedPublishedAPIs&tenant=carbon.super&start=1&end=100"`

Please note that the getAllPublishedAPIs API is now deprecated. You can get the same functionality from getAllPaginatedPublishedAPIs.

Add an Application

Description	Add a new application.
URI	http://localhost:9763/store/site/blocks/application/application-add/ajax/application-add.jag
URI Parameters	`action=addApplication&application=xxx&tier=xxx&description=xxx`
HTTP Methods	POST
Example	`curl -X POST -b cookies http://localhost:9763/store/site/blocks/application/application-add/ajax/application-add.jag -d 'action=addApplication&application=NewApp1&tier=Unlimited&description='`

Update an Application

Description	Update an existing application.
URI	http://localhost:9763/store/site/blocks/application/application-update/ajax/application-update.jag
URI Parameters	`action=updateApplication&applicationOld=<application_name>&applicationNew=<application_name>&callbackUrlNew=xxx&descriptionNew=xxx&tier=<tier_name>`
HTTP Methods	POST
Example	`curl -X POST -b cookies http://localhost:9763/store/site/blocks/application/application-update/ajax/application-update.jag -d 'action=updateApplication&applicationOld=NewApp1&applicationNew=NewApp2&tier=Unlimited&descriptionNew=&callbackUrlNew'`

Get Applications

Description	Get list of applications.
URI	http://localhost:9763/store/site/blocks/application/application-list/ajax/application-list.jag
URI Parameters	`?action=getApplications`
HTTP Methods	GET
Example	`curl -b cookies http://localhost:9763/store/site/blocks/application/application-list/ajax/application-list.jag?action=getApplications`

Get an Application by Name

Description	Get details of a single application by name.
URI	http://localhost:9763/store/site/blocks/application/application-list/ajax/application-list.jag
URI Parameters	`?action=getApplicationByName&applicationName=$APP_NAME`
HTTP Methods	GET
Example	`curl -b cookies 'http://localhost:9763/store/site/blocks/application/application-list/ajax/application-list.jag?action=getApplicationByName&applicationName=$APP_NAME'`

Remove an Application

Description	Remove an existing application.
URI	http://localhost:9763/store/site/blocks/application/application-remove/ajax/application-remove.jag
URI Parameters	`action=removeApplication&application=<application_name>`
HTTP Methods	POST
Example	`curl -X POST -b cookies http://localhost:9763/store/site/blocks/application/application-remove/ajax/application-remove.jag -d "action=removeApplication&application=NewApp2"`

Generate an Application Key

Description	Generate the key and secret values for a new application.
URI	http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag
URI Parameters	`action=generateApplicationKey&application=<app_name>&keytype=<PRODUCTION\|SANDBOX>&callbackUrl=<URL>&authorizedDomains=<The domains from which requests are allowed to the APIs>&validityTime=<time duration in seconds>&tokenScope` `tokenScope` is given in the request when your API has Auth scopes defined. See OAuth scopes.
HTTP Methods	POST
Examples	`curl -X POST -b cookies http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag -d 'action=generateApplicationKey&application=NewApp1&keytype=PRODUCTION&callbackUrl=&authorizedDomains=ALL&validityTime=360000'` `curl -X POST -b cookies http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag -d 'action=generateApplicationKey&application=NewApp1&keytype=SANDBOX&callbackUrl=&authorizedDomains=ALL&validityTime=360000& tokenScope=scope1'`

Update an Application Key

Description	Update the key and secret values for an application.
URI	http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag
URI Parameters	action=updateClientApplication& application=<app_name>&keytype=<PRODUCTION\|SANDBOX> &callbackUrl=<URL>& authorizedDomains=<The domains from which requests are allowed to the APIs>& validityTime=<time duration in seconds>&tokenScope `tokenScope` is given in the request when your API has Auth scopes defined. See OAuth scopes.
HTTP Methods	POST
Examples	curl -X POST -b cookies http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag -d 'action=updateClientApplication&application=NewApp1&keytype=PRODUCTION &callbackUrl=& authorizedDomains=ALL&validityTime=360000' curl -X POST -b cookies http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag -d 'action=updateClientApplication&application=NewApp1&keytype=SANDBOX&callbackUrl=&authorizedDomains=ALL&validityTime=360000& tokenScope=scope1 '

Add a Subscription

Description	Add a new API subscription.
URI	http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag
URI Parameters	By application name: `action=addAPISubscription&name=xxx&version=xxx&provider=xxx&tier=xxx&applicationName=xxx` By application ID: `action=addSubscription&name=xxx&version=xxx&provider=xxx&tier=xxx&applicationId=xxx`
HTTP Methods	POST
Example	By application name: `curl -X POST -b cookies http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag -d 'action=addAPISubscription&name=TestAPI&version=1.0.0&provider=admin&tier=Gold&applicationName=DefaultApplication'` By application ID: `curl -X POST -b cookies` `http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag -d 'action=addSubscription&name=TestAPI&version=1.0.0&provider=admin&tier=Gold&applicationId=1'`

List Subscriptions

Description	List all applications with active subscriptions, along with the access key information of each application.
URI	http://localhost:9763/store/site/blocks/subscription/subscription-list/ajax/subscription-list.jag
URI Parameters	action=getAllSubscriptions, selectedApp (optional) You can give an application's name in the s `electedApp` parameter. The API then returns the given application's s ubscribed APIs and access key information. If you do not specify this parameter, only the first application in the retrieved application list will contain subscribed API details, in addition to the access key information.
HTTP Methods	GET
Examples	`curl -b cookies http://localhost:9763/store/site/blocks/subscription/subscription-list/ajax/subscription-list.jag?action=getAllSubscriptions` `curl -b cookies 'http://localhost:9763/store/site/blocks/subscription/subscription-list/ajax/subscription-list.jag?action=getAllSubscriptions &selectedApp=NewApp1'`

List Subscriptions by Application

Description	List all API subscriptions of a given application.
URI	http://localhost:9763/store/site/blocks/subscription/subscription-list/ajax/subscription-list.jag
URI Parameters	`action=getSubscriptionByApplication&app=<application_name>`
HTTP Methods	GET
Example	`curl -b cookies 'http://localhost:9763/store/site/blocks/subscription/subscription-list/ajax/subscription-list.jag?action=getSubscriptionByApplication&app=DefaultApplication '`

List Subscriptions by API

Description	List all subscriptions of a given API.
URI	http://localhost:9763/store/site/blocks/subscription/subscription-list/ajax/subscription-list.jag
URI Parameters	`action=getSubscriptionByAPI&apiName=xxx&apiVersion=xxx&provider=xxx`
HTTP Methods	GET
Example	`curl -b cookies 'http://localhost:9763/store/site/blocks/subscription/subscription-list/ajax/subscription-list.jag?action=getSubscriptionByAPI&apiName=MyAPI&apiVersion=1.0.0&provider=admin'`

Remove a Subscription

Description	Remove an API subscription.
URI	http://localhost:9763/store/site/blocks/subscription/subscription-remove/ajax/subscription-remove.jag
URI Parameters	By application name: `action=removeSubscription&name=xxx&version=xxx&provider=xxx&applicationName=xxx` By application Id: `action=removeSubscription&name=xxx&version=xxx&provider=xxx&applicationId=xxx`
HTTP Methods	POST
Example	By application Name: `curl -X POST -b cookies` `http://localhost:9763/store/site/blocks/subscription/subscription-remove/ajax/subscription-remove.jag -d 'action=removeSubscription&name=PhoneVerification&version=1.0.0&provider=admin&applicationName=DefaultApplication'` By application Id: `curl -X POST -b cookies` `http://localhost:9763/store/site/blocks/subscription/subscription-remove/ajax/subscription-remove.jag -d 'action=removeSubscription&name=PhoneVerification&version=1.0.0&provider=admin&applicationId=1'`

Delete an OAuth Application

Description	Deletes an OAuth application in a third-party Authorization Server. If you delete it through the API Store UI, only the mapping that is maintained in the API Manager side will be deleted.
URI	http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag
URI Parameters	`action=deleteAuthApplication&consumerKey=<application_key>`
HTTP Methods	POST
Example	`curl -k -X POST -b cookies http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag -d 'action=deleteAuthApplication&consumerKey=4lHddsxCtpFa2zJE1EbBpJy_NIQa'`

Provision an Out-of-Band OAuth Client

Description	Provisions an OAuth client that was created out-of-band.
URI	http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag
URI Parameters	`action=mapExistingOauthClient&application=<APPLICATION NAME>&keytype=PRODUCTION/SANDBOX&callbackUrl=<URL>&authorizedDomains=<authorized_domains>&` `validityTime=<time duration in seconds>&client_id=<client-ID>` `<authorized_domains>`= The domains from which requests are allowed to the APIs.
HTTP Methods	POST
Example	`curl -X POST -b cookies` http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag`-d 'action=mapExistingOauthClient&application=NewApp1&keytype=PRODUCTION&callbackUrl=google.com&authorizedDomains=ALL&validityTime=3600&client_id=mPbgvinvpEk1QcSrw962TLICriUa& jsonParams={"username":"admin","key_type":"PRODUCTION","client_secret":"ynEI1ugq1_RCTJ9bM8jtD9RCsdoa","validityPeriod":"3600","client_id":"mPbgvinvpEk1QcSrw962TLICriUa"}'`

Clean Partially Created Keys

Description	Cleans any partially created keys from the API Manager database, before adding a new subscription. Partially created keys can remain in the API Manager databases when an OAuth application of a third-party authorization server gets deleted using the API Store UI. It only deletes the mapping that is maintained in the API Manager side.
URI	http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag
URI Parameters	`action=cleanUpApplicationRegistration&applicationName=xxx&keyType=PRODUCTION/SANDBOX'`
HTTP Methods	POST
Example	`curl -X POST -b cookies http://localhost:9763/store/site/blocks/subscription/subscription-add/ajax/subscription-add.jag -d 'action=cleanUpApplicationRegistration&applicationName=DefaultApplication&keyType=PRODUCTION'`

Get all Documentation

Description	Get all documents create for a given API
URI	http://localhost:9763 /store/site/blocks/api/listing/ajax/list.jag
URI Parameters	`action=getAllDocumentationOfApi&name=<API_name>&version=x.x.x&provider=<API_provider_name>"`
HTTP Methods	GET
Example	`curl -b cookies "http://localhost:9763`/store/site/blocks/api/listing/ajax/list.jag?action=getAllDocumentationOfApi&name=PhoneVerification&version=1.0.0&provider=admin`"`