yleoeditor API Documentation

GET /api (yleoeditor Root Service Discovery)

Returns the API metadata, supported versions, rate limits, and endpoint directory.

Headers

Accept: application/json

Response (200 OK)

{
  "name": "yleoeditor API Platform",
  "version": "1.0.0",
  "description": "Official REST API for Leonardo Daitx (yleoeditor) video editing portfolio.",
  "status": "operational",
  "documentation_url": "https://yleoeditor.com/docs",
  "developer_portal": "https://yleoeditor.com/developers",
  "openapi_spec": "https://yleoeditor.com/openapi.json",
  "endpoints": {
    "content": { "path": "/api/v1/content", "method": "GET" }
  },
  "versioning": {
    "current": "v1",
    "sunset_date": "2027-12-31T23:59:59Z",
    "deprecation_policy": "https://yleoeditor.com/docs#deprecation"
  }
}

GET /api/v1/content (yleoeditor Portfolio Dataset)

Retrieves the complete portfolio catalog including featured long-form video edits, viral shorts showcase, client creator channels, reviews, and social contacts.

Query Parameters

• category (string, optional): Filter by project category (e.g. Story-telling vlog, Documentary).
• limit (integer, optional): Maximum items to return (default: 10, max: 50).

Response (200 OK)

{
  "content": {
    "projects": [
      {
        "id": "1",
        "title": "I rented the strange houses in Brazil",
        "category": "Story-telling vlog",
        "thumbnail": "https://img.youtube.com/vi/r15MDHHW53k/maxresdefault.jpg",
        "youtubeId": "r15MDHHW53k",
        "views": "6.2M"
      }
    ],
    "shorts": [ ... ],
    "channels": [ ... ],
    "reviews": [ ... ],
    "socials": {
      "email": "leonnardomelo3@gmail.com",
      "twitter": "https://x.com/yleovideo",
      "discord": "https://discord.com/users/336156506682556416"
    }
  }
}

yleoeditor REST Versioning & RFC 8594 Deprecation Policy

The yleoeditor API adheres to strict versioning and deprecation lifecycle policies:

• Path-based Versioning: All versioned endpoints use /api/v1/ or /v1/ path prefixes.
• RFC 8594 Sunset Header: Every API response includes the standard Sunset: Fri, 31 Dec 2027 23:59:59 GMT header specifying when version 1 is planned for decommissioning.
• RFC 8594 Deprecation Header: When an endpoint is marked for deprecation, the Deprecation header and Link: <https://yleoeditor.com/docs#deprecation>; rel="deprecation" will be transmitted.
• Notice Period: Breaking changes are announced at least 180 days prior to retirement via /developers and /llms.txt.

yleoeditor Structured Error Responses (RFC 7807)

All non-2xx HTTP responses return structured machine-readable JSON containing an error code, human-readable message, and actionable hint:

{
  "type": "https://yleoeditor.com/docs#errors",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested API resource or endpoint was not found on yleoeditor.com.",
  "instance": "/api/nonexistent",
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested API endpoint was not found on yleoeditor.com.",
    "hint": "Please refer to /api, /openapi.json, /docs, or /llms.txt for all valid endpoints."
  }
}