Youdexsof Developer Resources

Youdexsof API endpoints

Every endpoint is a GET relative to https://www.youdexsof.ir and returns JSON.

• GET /api/blog

  Paginated list of published articles with title, description, cover image, tags, category, read time and view count in the requested language.

  lang

  Language of the returned title, description and tags.

  page

  1-based page number.

  limit

  Posts per page.

  category

  Filter by category slug.

  tag

  Filter by a single tag.

  search

  Full-text search across title and description.

  sort

  Ordering of the result set.

  featured

  Set to true to return only featured posts.

• GET /api/blog/{slug}

  Full article body plus metadata and comments for a single published post, in all three languages at once. The slug is the same one used in the /blog/{slug} page URL. Note that a GET increments the post's view counter.

  slug

  URL slug of the post.

• GET /api/blog/categories

  Every blog category with its slug, localized names, colour and published post count.

• GET /api/worksamples

  Shipped mobile and web projects with localized titles and descriptions, technologies used, project timeline, client and links.

• GET /api/products

  Premium WordPress themes and plugins for sale, with localized titles, descriptions, price, category and purchase URL.

• GET /api/works

  Employment and freelance history: organisation, localized role description, technologies, years and link.

• GET /api/education

  Academic background: institution, localized description and years attended.

• GET /api/events

  Hackathons, competitions and industry events, with localized descriptions, dates and certificate attachments.

• GET /api/github/pinned

  Open source repositories pinned on GitHub, with description, primary language, star and fork counts, homepage and repository URL. Cached for one hour.

• GET /api/site-settings

  Theme colours, profile picture path and the technology list shown in the skills section.

Youdexsof API access policy

Authentication

None. Every endpoint listed here is public and read-only; no API key, token or sign-up is required.

Write access

Write operations exist only behind the authenticated admin session and are not part of the public API.

Rate limits

No hard quota is enforced, but the site is a single personal deployment: keep requests under roughly 60 per minute and cache responses where you can.

CORS

The JSON endpoints are same-origin: call them server-side. The machine-readable documents (/openapi.json and the markdown representations) do send `Access-Control-Allow-Origin: *`, so a browser-side agent can read those directly.

Formats

Every endpoint returns JSON. Every HTML page also has a markdown representation: send `Accept: text/markdown` to the page URL (for example `https://www.youdexsof.ir/about`) and you get `text/markdown; charset=utf-8` back.

Youdexsof machine-readable documents

• Youdexsof OpenAPI specification

  OpenAPI 3.1 document describing every public read-only endpoint, its query parameters and responses.

• Youdexsof developer index

  Human-readable index of the public API, rate limits, authentication policy and support contact.

• Youdexsof llms.txt

  Condensed site summary with when-to-use guidance for AI agents, per the llms.txt convention.

• Youdexsof agent instructions

  Agent-facing instruction file: best-fit tasks, how to call the API and what this site cannot do.

• Youdexsof sitemap

  XML sitemap listing every indexable page.