მთავარ შინაარსზე გადასვლა
codeon
CodeOn Core
API reference

GET /api/v1/updates/<plugin>

განახლების endpoint-ი WordPress-თან თავსებად მანიფესტს მხოლოდ მაშინ აბრუნებს, როცა მომთხოვნი ამ პლაგინს ფლობს, ლიცენზია აქტიურია და დომენმა ლიცენზიის შემოწმება უკვე წარმატებით გაიარა.

მეთოდი
GET
მისამართი
/api/v1/updates/<plugin>

Query parameters

license_key
სავალდებულოა. მომხმარებლის CodeOn-ის ლიცენზიის კოდი.
site_url
სავალდებულოა. უკვე მიბმულ დომენს უნდა ემთხვეოდეს.
current_version
არასავალდებულოა, მაგრამ რეკომენდებულია. გამოიყენება ვერსიების შედარებისა და სამართავ პანელში სტატუსის განახლებისთვის.
build_id
არასავალდებულოა. იგივე watermark UUID, რომელიც validate-license-ის ტელემეტრიაში გამოიყენება.
GET /api/v1/updates/tbc-card?license_key=SMS-...&site_url=https%3A%2F%2Fstore.example.ge&current_version=0.3.10

წარმატებული შემთხვევები

{
  "version": "0.3.11",
  "tag": "v0.3.11",
  "name": "TBC Card Payments",
  "download_url": "https://codeon.ge/api/downloads/github/v0.3.11?...",
  "tested": "6.8",
  "description": "TBC Card Payments v0.3.11",
  "changelog": "..."
}

თუ საიტზე უკვე უახლესი ვერსია აყენია, endpoint-ი HTTP 200-ს ცარიელი JSON ობიექტით აბრუნებს. WordPress-ი განახლების გამოტოვებულ ველებს ისე აღიქვამს, როგორც განახლება არ არის ხელმისაწვდომი.

წვდომის შემოწმებები

  • პლაგინის slug-ი CodeOn-ის პლაგინების რეესტრში უნდა არსებობდეს.
  • ამ პლაგინისთვის GitHub-ის რეპოზიტორია კონფიგურირებული უნდა იყოს.
  • ლიცენზიის კოდი ვალიდური და აქტიური უნდა იყოს.
  • ლიცენზიის მოდული მოთხოვნილ პლაგინს უნდა ფარავდეს.
  • ლიცენზია იმავე დომენზე validate-license-ის მეშვეობით უკვე მიბმული უნდა იყოს.

შეცდომები

HTTPErrorმნიშვნელობა
400license_key and site_url requiredაკლია სავალდებულო მოთხოვნის პარამეტრები.
400invalid_license_formatკოდი საკონტროლო ჯამის შემოწმებას (checksum validation) ვერ გადის.
402license_inactiveვადაგასული ან გაუქმებული ლიცენზია.
402plugin_not_in_licenseლიცენზიის კოდი სწორია, მაგრამ პლაგინი მას არ ეკუთვნის.
403wrong_domainლიცენზია სხვა დომენზეა მიბმული.
403license_not_activated_on_this_domainჯერ წარმატებით გაუშვით validate-license.
404unknown_pluginპლაგინის slug-ი რეესტრში ვერ მოიძებნა.
502upstream_unavailableGitHub-ის რელიზის მოძიება ვერ შესრულდა.