Vridlo/api/vridlo.tag.index: Difference between revisions

From ALT Linux Wiki
(Created page with " == vridlo.tag.index == It allows accessing to a list of tags, which are presented in the system. Do not poll this method more than once an hour. Added into API v1.0. === Pa...")
 
(Blanked the page)
Tag: Blanking
 
Line 1: Line 1:


== vridlo.tag.index ==
It allows accessing to a list of tags, which are presented in the system. Do not poll this method more than once an hour.
Added into API v1.0.
=== Path ===
/v1/tags
=== Methods ===
==== GET ====
Returns a list of tags, 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 =====
* per_page (Optional)
Number of items to return per page. If this argument is omitted, it defaults to 10. The maximum allowed value is 50.
* page (Optional)
The page of results to return. If this argument is omitted, it defaults to 1.
NOTE: Arguments can be provided as arguments along with headers fields.
===== Example Response =====
[
  {
      "id": 1,
      "name": "2",
      "description": "Info tag",
      "used_in_rpm_count": 2,
  }
]
===== Return Codes =====
* '''200''' (''OK'')
The resource list is accessible. Returned data responds to the current state of the resource list, and reading the list is finished.
* '''206''' (''Partial Content'')
The resource list is accessible. Returned data responds to the current state of the resource list, and reading the list is NOT finished yet.
* '''416''' (''Range Not Satisfiable'')
The resource list is accessible. But data can't be returned since range provided don't match the list boundaries.
* '''422.3''' (''SSL is required'')
SSL is required to access the Vridlo API.
* '''500''' (''Service currently unavailable'')
The requested service is temporarily unavailable.

Latest revision as of 14:37, 27 November 2019