Host

Modify proxy hosts and update the configuration.

put/api/hosts

Request

  • Base URL
    https://api.ha-man2.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.ha-man2.com/api/hosts
  • Auth
    OAuth 2
    Password
    Token URL: /api/admin/token

Request body

idinteger nullable
remarkstring required
addressstring[]
inbound_tagstring nullable
portinteger nullable
snistring[] nullable
hoststring[] nullable
pathstring nullable
security'inbound_default' | 'none' | 'tls'
alpnProxyHostALPN[] nullable
fingerprint'' | 'chrome' | 'firefox' | 'safari' | 'ios' | 'android' | 'edge' | '360' | 'qq' | 'random' | 'randomized' | 'randomizednoalpn' | 'unsafe'
allowinsecureboolean nullable
is_disabledboolean
http_headersobject nullable
random_user_agentboolean
use_sni_as_hostboolean
vless_routestring nullable
priorityinteger required
statusUserStatus[] nullable
pinned_peer_cert_sha256string nullable
verify_peer_cert_by_namestring[] nullable
cipher_suitesstring nullable

Response

Successful Response

idinteger nullable
remarkstring required
addressstring[]
inbound_tagstring nullable
portinteger nullable
snistring[] nullable
hoststring[] nullable
pathstring nullable
security'inbound_default' | 'none' | 'tls'
alpnProxyHostALPN[] nullable
fingerprint'' | 'chrome' | 'firefox' | 'safari' | 'ios' | 'android' | 'edge' | '360' | 'qq' | 'random' | 'randomized' | 'randomizednoalpn' | 'unsafe'
allowinsecureboolean nullable
is_disabledboolean
http_headersobject nullable
random_user_agentboolean
use_sni_as_hostboolean
vless_routestring nullable
priorityinteger required
statusUserStatus[] nullable
pinned_peer_cert_sha256string nullable
verify_peer_cert_by_namestring[] nullable
final_mask_settingsobject nullable
cipher_suitesstring nullable

Changes

    • breaking

      removed from the / request property anyOf list

    • breaking

      the response property ////// became optional for the status

    • breaking

      the response property ////// became optional for the status

    • breaking

      response property items/noise_settings/anyOf[subschema #1: NoiseSettings]/xray/anyOf[subschema #1]/items/delay list-of-types was widened by adding types integer and null to media type application/json of response 200

    • breaking

      response property items/noise_settings/anyOf[subschema #1: NoiseSettings]/xray/anyOf[subschema #1]/items/packet list-of-types was widened by adding types array and null to media type application/json of response 200

    • warning

      changed the pattern of the request property ////// from ^(:?rand|str|base64|hex)$ to ^$|^(:?rand|str|base64|hex)$

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property //////

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property ////// from the response with the status

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /////

    • info

      added the new optional request property //////

    • info

      added to the / request property anyOf list

    • info

      the request property ////// became optional

    • info

      the request property ////// became optional

    • info

      request property ////// list-of-types was widened by adding types integer and null to media type application/json

    • info

      request property ////// list-of-types was widened by adding types array and null to media type application/json

    • info

      removed the pattern ^\d{1,16}(-\d{1,16})?$ from the request property //////

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added to the / response property anyOf list for the response status

    • info

      removed from the / response property anyOf list for the response status

    • info

      the ////// response's property pattern was changed from ^(:?rand|str|base64|hex)$ to ^$|^(:?rand|str|base64|hex)$ for the status

    • info

      the ////// response's property pattern ^\d{1,16}(-\d{1,16})?$ was removed for the status