Ids and names in paths

Where a path has {id}, a service, a datastore or an env group accepts its id or its name.

Two paths, the same service

/api/v1/services/api
/api/v1/services/srv-60f5973b037e4478ae7b

A id is a prefix and 20 hex characters. The prefixes are srv, dep, job, dbs and evg.

What a path accepts

Resource	Prefix	Example of an id	In a path
Service	`srv`	`srv-60f5973b037e4478ae7b`	The id or the name
Datastore	`dbs`		The id or the name
Env group	`evg`	`evg-c15c37b6f91044ff920b`	The id or the name
Deploy	`dep`	`dep-3271cdfd1415400d9a5e`	The id only
Job run	`job`		The id only
Deploy hook			The id of the service only

Ferry refuses a name that looks like an id. Thus Ferry always knows if a path has an id or a name.

Request bodies

The body of a request is JSON. Two endpoints also take a different content type.

Size limits

A request body has 2 MiB at most. Uploads and GitHub deliveries have their own limits.