Electrode Native
Search…
Primary version
INTRODUCTION
CLI COMMANDS
create-api
Description
- Create a new API project based on a Swagger schema
Syntax
ern create-api <apiName>Arguments
<apiName>- The name to use for this API. The API name must follow Electrode Native module name rules.
- We recommend suffixing the name of API with suffix
-api
Options
--scope/-s <scope>- Specify a given npm scope for the API project package
- Add the package scope automatically in the
package.jsonof the generated API. - Default Package will be unscoped.
--packageName/-p <name>- Specify the npm package name to use for the API.
- Add the package name automatically in the
package.jsonof the generated API. - Default The command will prompt for the package name to use.
--apiVersion/-a <version>- Specify an initial version for the API
- Default If this option is not used, the API defaults to 0.0.1.
--apiAuthor/-u <author>- Specify the author of the API in the
package.jsonfile of the API - Default If this option is not used, the author is not set.
--schemaPath/-m <schemaPath>- Generate the API using a pre-existing Swagger schema located at the given
schemaPath - Default If this option is not used the command uses a default starter schema to generate the initial API. You can modify this option at a later time and then regenerate the API using the
ern regen-apicommand.
--skipNpmCheck- Skip the check ensuring package does not already exists in npm registry
- Default The value defaults to false.
--manifestId <manifestId>- Id of the override Manifest entry to retrieve dependencies versions from (see override Manifest for more info)
Examples
ern create-api weather
This example shows how to create a unscoped package named weather-api. The API project is located in the new directory named weather.ern create-api weather --scope MyCompany
This example shows how to create a scoped package named @MyCompany/weather-api.ern create-api weather --schemaPath schema.json
This example shows how to create a unscoped package named weather-api. The API project is located in the new directory named weather. The --schemaPath option specifies location of file containing pre-existing Swagger schema.Remarks
- The generated API project contains the API client-code for the three platforms (JavaScript, Android, and iOS) as well as any models and code to guide the implementation of the API.
- The generated API project is meant to be published to npm and it contains the
package.jsonfile. - Once you have a version of your API ready, you should publish it to npm to make it available for people to use. Considering that the API is published to npm, you should make sure before generating the API, that the name is not already used by another API otherwise you won't be able to publish an API with a duplicate name.
- The API project is created in a new directory named after the API project name.
Related commands
​ern regen-api | Add a new request, event, or model to an existing API project schema and regenerate the API
ern create-api-impl | Create an implementation skeleton project for a specified API
Last modified 1yr ago
Copy link