تخطَّ إلى المحتوى

Deprecation Registry API

هذا المحتوى غير متوفر بلغتك بعد.

Deprecation Registry API

GET https://ping.nself.org/api/deprecation-registry.json

Returns the current plugin API version and deprecation state for all ɳSelf plugins. No authentication required.

Response

{
  "schema_version": "1",
  "generated_at": "2026-04-23T00:00:00Z",
  "lts_baseline": "1.0.9",
  "lts_window_end": "2027-04-17",
  "plugins": [
    {
      "name": "ai",
      "api_version": "1.3.0",
      "deprecated_endpoints": []
    },
    {
      "name": "auth",
      "api_version": "1.1.0",
      "deprecated_endpoints": []
    }
  ]
}

Fields

Field	Type	Description
`schema_version`	string	Registry format version (currently `"1"`)
`generated_at`	string	ISO 8601 UTC timestamp of registry generation
`lts_baseline`	string	nself version that established this support baseline
`lts_window_end`	string	Date (ISO 8601) when the support window closes
`plugins[].name`	string	Plugin name (matches `plugin.json` `name` field)
`plugins[].api_version`	string	Current SemVer of the plugin’s HTTP API
`plugins[].deprecated_endpoints`	array	List of deprecated endpoint entries (empty at v1.1.0 baseline)

Deprecated Endpoint Object

When deprecated_endpoints is non-empty:

{
  "path": "/v1/complete",
  "deprecated_in": "1.2.0",
  "removed_in": "2.0.0",
  "replacement": "/v2/complete",
  "reason": "Unified completion API with streaming support",
  "sunset_header": "Sat, 01 Jan 2027 00:00:00 GMT"
}

Field	Type	Description
`path`	string	HTTP path of the deprecated endpoint
`deprecated_in`	string	Plugin API version when the endpoint was deprecated
`removed_in`	string	Plugin API version when the endpoint will be removed
`replacement`	string	Path or description of the replacement
`reason`	string	Human-readable rationale
`sunset_header`	string	RFC-1123 UTC date for the `Sunset` HTTP header

Caching

The response is served with Cache-Control: no-store. Fetch fresh for CI checks. For long-lived consumers, cache locally with a TTL of your choice.

See Also