Vridlo/api/vridlo.rpms: Difference between revisions

From ALT Linux Wiki
(Created page with "== vridlo.rpm.slug == This allows accessing to the specified rpm record by <slug> URI-parameter. Added into API v1.0. === Path === /v1/rpms/<slug> === Methods === ==== PO...")
 
Line 22: Line 22:
  Name of the rpm.
  Name of the rpm.
* epoch (Optoinal)
* epoch (Optoinal)
  Name of the rpm.
  Epoch of the rpm build.
* version (Mandatory)
* version (Mandatory)
  Name of the rpm.
  Version of the rpm build. Must be valid.
* release (Mandatory)
* release (Mandatory)
  Name of the rpm.
  Release of the rpm build. Must be valid.
* arch (Mandatory)
* arch (Mandatory)
  Name of the rpm.
  Arch of the rpm build. Must be valid.
* description (Optional)
Description of the rpm.
* built_at (Mandatory)
* built_at (Mandatory)
  Name of the rpm.
  Rpm Built at time. Must be valid.
* group_id (Mandatory)
* group_id (Mandatory)
  Group Id which the rpm is belong to. Must be valid.
  Group Id which the rpm is belong to. Must be valid.
Line 39: Line 41:
* builder_id (Mandatory)
* builder_id (Mandatory)
  Id of the builder. Must be valid.
  Id of the builder. Must be valid.
* description (Optional)
Description of the rpm.
* src_id (Optional)
* src_id (Optional)
  Id of the source repo. Must be valid if arch is not "src", or blank if arch is "src".
  Id of the source repo. Must be valid if arch is not "src", or blank if arch is "src".

Revision as of 20:20, 7 October 2019

vridlo.rpm.slug

This allows accessing to the specified rpm record by <slug> URI-parameter. Added into API v1.0.

Path

/v1/rpms/<slug>

Methods

POST

Creates the rpm specified by <slug> URI-parameter using the set of properties passed as form data or get parameter array, and returns state of the created record as JSON.

Authentication

This method requires write authentication with write permission to rpm model.

Arguments
  • name (Mandatory)
Name of the rpm.
  • epoch (Optoinal)
Epoch of the rpm build.
  • version (Mandatory)
Version of the rpm build. Must be valid.
  • release (Mandatory)
Release of the rpm build. Must be valid.
  • arch (Mandatory)
Arch of the rpm build. Must be valid.
  • description (Optional)
Description of the rpm.
  • built_at (Mandatory)
Rpm Built at time. Must be valid.
  • group_id (Mandatory)
Group Id which the rpm is belong to. Must be valid.
  • sha (Mandatory)
Sha of rpm file. Must be valid.
  • size (Mandatory)
Size of the rpm.
  • builder_id (Mandatory)
Id of the builder. Must be valid.
  • src_id (Optional)
Id of the source repo. Must be valid if arch is not "src", or blank if arch is "src".
  • repo_status (Optional)
Status of validation the package by a repocop.
Example Response

Good response with created record: 

[
 {
  "name": "ruby",
  "epoch": "1",
  "version": "2.5.5",
  "release": "alt1",
  "arch": "src",
  "built_at": "10.10.10 10:10:10",
  "description": "ruby package",
  "group_id": 100,
  "md5": "236abd7880b4577f2b9470c09fee79d6",
  "sha": "4a01982354f6d7cab8d9275e43dc0e4329b1d307",
  "size": "100000",
  "builder_id": 1000,
  "src_id": 100000,
  "repo_status": "skip",
 }
]

Error response 423: 

[
 {
  "error_code": 3
 }
]
Return Codes
  • 200 (OK)
The resource wasn't found, and was created. Returned data responds to the current state of the resource.
  • 422.3 (SSL is required)
SSL is required to access the Vridlo API.
  • 422.5 (Invalid incoming data)
The incoming data is invalid. See details for help.
  • 404 (Not Found)
The record with provided slug is not found.
  • 500 (Internal Server Error)
The Internal Server Error has occurred.

GET

Gets properties of the rpm specified by <slug> URI-parameter, and returns then as JSON. Do not poll this method more than once an hour.

Authentication

This method requires NO authentication.

Arguments

This method requires NO arguments.

Example Response

Good response: 

[
 {
  "name": "ruby",
  "epoch": "1",
  "version": "2.5.5",
  "release": "alt1",
  "arch": "src",
  "built_at": "10.10.10 10:10:10",
  "description": "ruby package",
  "group_id": 100,
  "group_name": "Development/Ruby",
  "md5": "236abd7880b4577f2b9470c09fee79d6",
  "sha": "4a01982354f6d7cab8d9275e43dc0e4329b1d307",
  "size": "100000",
  "builder_name": "Ruby Builder Bot",
  "builder_id": 1000,
  "src_id": 100000,
  "repo_status": "skip",
 }
]

Error response 423: 

[
 {
  "error_code": 3
 }
]
Return Codes
  • 200 (OK)
The resource was found and is accessible. Returned data responds to the current state of the resource.
  • 422.3 (SSL is required)
SSL is required to access the Vridlo API.
  • 404 (Not Found)
The record with provided slug is not found.
  • 500 (Internal Server Error)
The Internal Server Error has occurred.

PUT/PATCH

Sets one or many properties of the rpm specified by <slug> URI-parameter, and returns updated state as JSON.

Authentication

This method requires write authentication with write permission to rpm model.

Arguments
  • name (Mandatory)
Name of the rpm.
  • epoch (Optoinal)
Name of the rpm.
  • version (Mandatory)
Name of the rpm.
  • release (Mandatory)
Name of the rpm.
  • arch (Mandatory)
Name of the rpm.
  • built_at (Mandatory)
Name of the rpm.
  • group_id (Mandatory)
Group Id which the rpm is belong to. Must be valid.
  • sha (Mandatory)
Sha of rpm file. Must be valid.
  • size (Mandatory)
Size of the rpm.
  • builder_id (Mandatory)
Id of the builder. Must be valid.
  • description (Optional)
Description of the rpm.
  • src_id (Optional)
Id of the source repo. Must be valid if arch is not "src", or blank if arch is "src".
  • repo_status (Optional)
Status of validation the package by a repocop.
Example Request

PUT:/v1/rpms/ca?name=Core_Assembler

Example Response

Good response: 

[
 {
  "name": "ruby",
  "epoch": "1",
  "version": "2.5.5",
  "release": "alt1",
  "arch": "src",
  "built_at": "10.10.10 10:10:10",
  "description": "ruby package",
  "group_id": 100,
  "md5": "236abd7880b4577f2b9470c09fee79d6",
  "sha": "4a01982354f6d7cab8d9275e43dc0e4329b1d307",
  "size": "100000",
  "builder_id": 1000,
  "src_id": 100000,
  "repo_status": "skip",
 }
]

Error response 423: 

[
 {
  "error_code": 3
 }
]
Return Codes
  • 200 (OK)
The resource was found and is accessible. Changes were made on the resource successfully. Returned data responds to the current state of the resource.
  • 204 (No Content)
The resource was found and is accessible. But no changes were made on the resource.
  • 422.3 (SSL is required)
SSL is required to access the Vridlo API.
  • 422.5 (Invalid incoming data)
The incoming data is invalid. See details for help.
  • 404 (Not Found)
The record with provided id/slug is not found.
  • 500 (Internal Server Error)
The Internal Server Error has occurred.

DELETE

Destroys the rpm specified by <slug> URI-parameter, and returns state of the destroyed record as JSON.

Authentication

This method requires write authentication with write permission to rpm model.

Arguments

This method requires NO arguments.

Example Response

Good response returning deleted record: 

[
 {
  "name": "ruby",
  "epoch": "1",
  "version": "2.5.5",
  "release": "alt1",
  "arch": "src",
  "built_at": "10.10.10 10:10:10",
  "description": "ruby package",
  "group_id": 100,
  "group_name": "Development/Ruby",
  "md5": "236abd7880b4577f2b9470c09fee79d6",
  "sha": "4a01982354f6d7cab8d9275e43dc0e4329b1d307",
  "size": "100000",
  "builder_name": "Ruby Builder Bot",
  "builder_id": 1000,
  "src_id": 100000,
  "repo_status": "skip",
 }
]

Error response 423: 

[
 {
  "error_code": 3
 }
]
Return Codes
  • 200 (OK)
The resource was found and is accessible, and successfully destroyed. Returned data responds to the state of the destroyed resource.
  • 422.3 (SSL is required)
SSL is required to access the Vridlo API.
  • 404 (Not Found)
The record with provided slug is not found.
  • 500 (Internal Server Error)
The Internal Server Error has occurred.