Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Alternative discovery mechanism

Open
#676 9 comments 1 reaction 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Quiet
Tech stack
json, yaml
Domain
api, web-dev

Research direction

The issue names providers/manifest.yml and proposes a root-level oembed.json; start by reading the current registry and per-site link-tag discovery approaches, then review the nine-comment discussion. Done means the extension's location, response format, and CORS behavior are specified clearly enough for implementation.

Written by the indexing model from the issue text.

Description

stale

Hi there,

I much appreciate the spec! Now I am wondering (and do let me know if this is an old discussion), if there is interest in an extension which would allow for a site-wide discovery mechanism. I.e. from what I can tell currently a provider can either

  1. list themselves in the registry or
  2. put a link-tag on the specific site which should be embeded.

Now for my use case both are not feasible paths, because

  1. I am looking at a federated roaster of domains which rotate a lot, so registering them is too manual of a process.
  2. I want to know about embed-ability from a CORS-secured context, where I can not request (and for size reasons, also don't want to) it on a per-URL basis.

So I was wondering if there would be interest in a spec extension for exposing sth similar to the providers/manifest.yml on a top-level (in a possibly CORS friendly way)?

I'm not entirely sure yet how it'd look like, I guess the simplest version would be to serve a oembed.json on the root. I understand this is not the most backwards-compatible way, since it also infringes on web developers freedom to use all their routes to their liking.
Then again with sitemap.xml or robots.txt, there is some precedence for hardcoded files, so it might actually be fine?

Dominant language
PHP
Stars
1.4k
Forks
773
Avg merge
11h 21m
Merged PRs (30d)
14

Getting set up

  • Ships a Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from iamcal/oembed

All issues in iamcal/oembed

Similar issues

More PHP issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.