iamcal / oembed

The oEmbed Spec
http://oembed.com
MIT License
1.32k stars 651 forks source link

Figure out what to do about endpoints that require further authentication #474

Open iamcal opened 4 years ago

iamcal commented 4 years ago

See Instagram in #468

Saleh56 commented 3 years ago

Sss

raae commented 3 years ago

Could there be an idea to add to the endpoint information the param needs to be set for authentication? It could both indicate the need for authentication and disclose the param needed.

For instagram then:

---
- provider_name: Instagram
  provider_url: https://instagram.com
  endpoints:
  - schemes:
      - http://instagram.com/*/p/*,
      - http://www.instagram.com/*/p/*,
       ...
    url: https://graph.facebook.com/v9.0/instagram_oembed
    auth_param: access_token
    docs_url: https://developers.facebook.com/docs/instagram/oembed
    example_urls:
      - https://graph.facebook.com/v9.0/instagram_oembed?url=https%3A%2F%2Finstagram.com%2Fp%2FV8UMy0LjpX%2F
    formats:
      - json
    notes:
      - 'This endpoint requires a facebook app with the oEmbed Product attached'
...