matrix-org / matrix-org/matrix-spec

API to send an image/file from a remote URL (SPEC-317)

Open
#143 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

A-Client-Server feature
Dominant language
HTML
Stars
330
Forks
150
Avg merge
2h 21m
Merged PRs (30d)
3

Description

Submitted by @​matthew:matrix.org
Currently you have to download images manually and then POST them to media/v1/upload if you want to reference them in a message via an mxc:// URL. It might be nice to provide an API to let people reference remote HTTP URLs, and have the server go spider it and package it up in an mxc:// URL alongside actually sending the message. This is kinda related to https://github.com/matrix-org/matrix-doc/issues/592

(Imported from https://matrix.org/jira/browse/SPEC-317)

Contributor guide

Open the 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.

Research direction

Start by reviewing the existing media/v1/upload flow and the related matrix-org/matrix-doc issue 592. Define the remote-URL API behavior, fetching and packaging requirements, and how the resulting mxc:// URL is used when sending a message; the work is done when the specification is sufficiently precise for implementation.

Written by the indexing model from the issue text.

Assessment

Domain
api
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.