Skip to content

velmie/client-request-headers

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 

Repository files navigation

Velmie Client's headers requirements


Version: 1.0


Headers

  • V-Client-Name
  • V-Client-Type
  • V-Client-Device-Id
  • V-Client-Version-Name
  • V-Client-Version-Build
  • V-Client-Version-Commit
  • V-Client-Session-Id
  • V-Client-Request-Id
  • User-Agent

Please note, that all information in headers should be in ASCII encoding!


Example

V-Client-Name: App Name Mobile Flutter
V-Client-Type: mobile
V-Client-Device-Id: 46317361-69bc-4475-a552-17d7f4cca8be
V-Client-Version-Name: 1.0.3
V-Client-Version-Build: 47
V-Client-Version-Commit: fd5064f
V-Client-Session-Id: 36a54006-71df-4234-8db3-d6ba02ed72d5
V-Client-Request-Id: fd4c197b-eb02-4568-a0ff-9f0e31284831
User-Agent: CFNetwork/897.15 Darwin/17.5.0 (iPhone/6s iOS/11.3)

Description

V-Client-Name: The name of the client. For example, it can be a hybrid or native mobile app, frontend app, package, etc.

V-Client-Type: The type of the client. It must be one of the following values: web, mobile, desktop, cli, other

  • web: Client that runs in any web browser. Can be used on any device with a web browser including desktops, laptops, tablets, and smartphones.

  • mobile: Client that is built specifically for mobile devices. Developed for operating systems like Android or iOS and can be installed on phones or tablets.

  • desktop: Client that is developed to run on desktop operating systems. Stand-alone applications typically running on Windows, MacOS, Linux, etc.

  • cli: Client known as Command Line Interface. Text-based interface used to run commands on the OS. Used by programmers and administrators for scripting and automation.

  • other: Catch-all category for any other type of client not covered by the categories above. Includes clients developed for specific hardware or platforms, e.g. smart TVs, smartwatches, game consoles, etc.

V-Client-Device-Id: A unique identifier of the device.

V-Client-Version-Name: A version of the software.

V-Client-Version-Build: The number of the build. Usually, it is started at 1 and increased by 1 with each build of the software.

V-Client-Version-Commit: The reference to a particular commit hash that is used to build the software.

V-Client-Session-Id: A unique identifier of the client's session. E.g.:

  • For a library, it is generated each time after its initialization;
  • For a mobile app it is generated each time when the app has started;
  • For a frontend app it is generated each time when the app has been loaded by a user via a browser;

V-Client-Request-Id: A unique identifier of the request to the server/backend. It should be re-generated every request, i.e. - be unique. It is used to trace the whole request path.

User-Agent: Describes identifier of the software, operating system, vendor, and/or version of the requesting. Web browsers provide this header by default. Thus it should be implemented in libraries and mobile applications.


About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •