get status

GET 
/status

Get API status and version

Responses

200

Ok

application/json

Schema

Schema

status OrangeApiStatusValue (string)required

Possible values: [ok, ko]

Service status ok | ko

name stringrequired

Your service internal name.

version stringrequired

major.minor.patch see semver.org or G00R00C00

components

object[]

Each array entry represents a component your service requires (other web service, database, etc) to be fully functional

Array [

status OrangeApiStatusValue (string)required

Possible values: [ok, ko]

Component status ok | ko

name stringrequired

Component internal name.

version stringrequired

major.minor.patch see semver.org or G00R00C00

]

Example (from schema)

{
  "status": "ok",
  "name": "string",
  "version": "string",
  "components": [
    {
      "status": "ok",
      "name": "string",
      "version": "string"
    }
  ]
}

400

Bad Request

Request is not valid

application/json

Schema

Schema

code int32required

An integer coding the error type. This is given to caller so he can translate them if required.

message stringrequired

A short localized string that describes the error.

description string

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (from schema)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

401

Unauthorized

Credentials are missing

application/json

Schema

Schema

code int32required

An integer coding the error type. This is given to caller so he can translate them if required.

message stringrequired

A short localized string that describes the error.

description string

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (from schema)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

403

Forbidden

Valid credentials but not enough privileges to perform the operation

application/json

Schema

Schema

code int32required

An integer coding the error type. This is given to caller so he can translate them if required.

message stringrequired

A short localized string that describes the error.

description string

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (from schema)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

404

Not Found

Unknown resource or service

application/json

Schema

Schema

code int32required

An integer coding the error type. This is given to caller so he can translate them if required.

message stringrequired

A short localized string that describes the error.

description string

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (from schema)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

405

Method Not Allowed

Operation is not valid according to the state of the resource

application/json

Schema

Schema

code int32required

An integer coding the error type. This is given to caller so he can translate them if required.

message stringrequired

A short localized string that describes the error.

description string

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (from schema)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

500

Internal Server Error

Unexpected error, please contact support

application/json

Schema

Schema

code int32required

An integer coding the error type. This is given to caller so he can translate them if required.

message stringrequired

A short localized string that describes the error.

description string

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (from schema)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

503

Service Unavailable

Service probably in maintenance. Please retry later.

application/json

Schema

Schema

code int32required

An integer coding the error type. This is given to caller so he can translate them if required.

message stringrequired

A short localized string that describes the error.

description string

(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.

Example (from schema)

{
  "code": 0,
  "message": "string",
  "description": "string"
}

Loading...