Vridlo/api/vridlo.arches

vridlo.arches
It allows accessing to a list of arches, which are presented in the system. Do not poll this method more than once an hour. Added into API v1.0. It implements operation on the Arch structure.

GET:/v1/arches.json
Returns a list of arches, which are presented in the system. Do not poll this method more than once an hour. Added into API v1.0.

Authentication
This method requires NO authentication.

Arguments
NOTE: Arguments can be provided as arguments along with headers fields.

Number of items to return per page. If this argument is omitted, it defaults to 10. The maximum allowed value is 50.
 * per_page is natural optional

The page of results to return. If this argument is omitted, it defaults to 1.
 * page is natural optional

Slug of the RPM architecture. Examples: i586, aarch64. If it begins with tilda char it is treated as regexp.
 * slug is string optional

Search over the architecture names array. If it begins with tilda char it is treated as regexp.
 * names is string optional

File path part relative from the assembler's path base for exporting of the source or built RPMs. If it begins with tilda char it is treated as regexp.
 * relative_path is string optional

Example Request Url
GET:/v1/arches.json?names=~Arch

Example Good Response
[   {       "slug": "x86_64", "relative_path": "export/path/to" "names": [ {            "kind": "title", "text": "x86_64 Arch", "icu_locale": "en_US", },      },       apps_count: 0 },   {       "slug": "i587", "relative_path": "export/path/to/sec/" "names": [ {            "kind": "title", "text": "i587 Arch", "icu_locale": "en_US", },      },       apps_count: 0 } ]

Example Bad Response
Error response 416:

{   "message": "Error text according the active language", }

Return Codes
The resource list is accessible. Returned data responds to the current state of the resource list, and reading the list is finished.
 * 200 (OK)

The resource list is accessible. Returned data responds to the current state of the resource list, and reading the list is NOT finished yet.
 * 206 (Partial Content)

The resource list is accessible. But data can't be returned since range provided don't match the list boundaries.
 * 416 (Range Not Satisfiable)

SSL is required to access the Vridlo API.
 * 422.3 (SSL is required)

The requested service is temporarily unavailable.
 * 500 (Service currently unavailable)

POST:/v1/arches.json
Creates the arch specified by URI-parameter using he set of properties passed as form data or get parameter array, and returns state of the created record as JSON. Added into API v1.0.

Authentication
This method requires write authentication with write permission to arch model.

Arguments
Name array for the architecture. It can include the only title kind texts.
 * names is Name array mandatory

Slug of the RPM architecture. Can contain only letters, digits and underscores. Is unique per system.
 * slug is string mandatory write-once

File path part relative from the assembler's path base for exporting of the source or built RPMs.
 * relative_path is string optional

Example Request Form
POST:/v1/arches.json DATA: {   "slug": "i587", "export_path_base": "i587", "names": [ {         "kind": "title", "text": "i587 Arch", "icu_locale": "en_US", },   }, }

Example Good Response
Good response with created record:

{   "slug": "i587", "export_path_base": "i587", "names": [ {         "id": 1010, "kind": "title", "text": "i587 Arch", "icu_locale": "en_US", },   },    apps_count: 0 }

Example Bad Response
Error response 422:

{  "error_code": 3, "message": "Error text according the active language", }

Return Codes
The resource wasn't found, and was created. Returned data responds to the current state of the resource.
 * 200 (OK)

SSL is required to access the Vridlo API.
 * 422.3 (SSL is required)

The record with provided slug is not found.
 * 404 (Not Found)

The Internal Server Error has occurred.
 * 500 (Internal Server Error)

GET:/v1/arches/ .json
Gets properties of the arch specified by URI-parameter, and returns then as JSON. Do not poll this method more than once an hour. Added into API v1.0.

Authentication
This method requires NO authentication.

Arguments
This method requires NO arguments.

Example Request Url
GET:/v1/arches/i587.json

Example Good Response
Good response with the returned record:

{   "slug": "i587", "export_path_base": "i587", "names": [ {         "id": 1010, "kind": "title", "text": "i587 Arch", "icu_locale": "en_US", },   },    apps_count: 0 }

Example Bad Response
Error response 422:

{  "error_code": 3, "message": "Error text according the active language", }

Return Codes
The resource was found and is accessible. Returned data responds to the current state of the resource.
 * 200 (OK)

SSL is required to access the Vridlo API.
 * 422.3 (SSL is required)

The record with provided slug is not found.
 * 404 (Not Found)

The Internal Server Error has occurred.
 * 500 (Internal Server Error)

PATCH:/v1/arches/ .json
Sets one or many properties of the arch specified by URI-parameter, and returns updated state as JSON. Added into API v1.0.

Authentication
This method requires write authentication with write permission to arch model.

Arguments
NOTE: Blank fields will be skipped

Name array for the architecture. It can include the only title kind texts.
 * names is Name array mandatory

Slug of the RPM architecture. Can contain only letters, digits and underscores. Is unique per system.
 * slug is string mandatory write-once

File path part relative from the assembler's path base for exporting of the source or built RPMs.
 * relative_path is string optional

Example Request Form
PATCH:/v1/arches/ca.json DATA: {   "names": [ {         "id": 1010, "kind": "title", "text": "i587 Arch", "icu_locale": "en_US", },   }, }

Example Good Response
{   "slug": "i587", "export_path_base": "i587", "names": [ {         "id": 1010, "kind": "title", "text": "i587 Arch", "icu_locale": "en_US", },   },    apps_count: 0 }

Example Bad Response
Error response 422:

{  "error_code": 3, "message": "Error text according the active language", }

Return Codes
The resource was found and is accessible. Changes were made on the resource successfully. Returned data responds to the current state of the resource.
 * 200 (OK)

The resource was found and is accessible. But no changes were made on the resource.
 * 204 (No Content)

SSL is required to access the Vridlo API.
 * 422.3 (SSL is required)

The record with provided id/slug is not found.
 * 404 (Not Found)

The Internal Server Error has occurred.
 * 500 (Internal Server Error)

DELETE:/v1/arches/ .json
Destroys the arch specified by URI-parameter, and returns state of the destroyed record as JSON. Added into API v1.0.

Authentication
This method requires write authentication with write permission token to arch model.

Arguments
This method requires NO arguments.

Example Request Url
DELETE:/v1/arches/i587.json

Example Good Response
Good response returning deleted record:

{   "slug": "i587", "export_path_base": "i587", "names": [ {         "kind": "title", "text": "i587 Arch", "icu_locale": "en_US", },   },    apps_count: 0 }

Example Bad Response
Error response 422:

{  "error_code": 3, "message": "Error text according the active language", }

Return Codes
The resource was found and is accessible, and successfully destroyed. Returned data responds to the state of the destroyed resource.
 * 200 (OK)

SSL is required to access the Vridlo API.
 * 422.3 (SSL is required)

The record with provided slug is not found.
 * 404 (Not Found)

The Internal Server Error has occurred.
 * 500 (Internal Server Error)