Link API

[samdark]

GET /link?url=x

{
  url: bla-bla
}

POST /link

{
  url: xxx
}

DELETE /link?url=x

[romkatsu]

Методы должны быть доступны без авторизации?

В методе GET, x - какого типа? Это id Link в бд?

[samdark]

Методы должны быть доступны без авторизации?

Авторизация по токену.

В методе GET, x - какого типа? Это id Link в бд?

Строка. Это нормализованная ссылка аля domain.com/bla-bla.

[xepozz]

Немного поразмыслив, я понял одну вещь: мы зря завязались на сущность Link.

1. Link - это частный случай "предложения".
2. Link - заставляет нас ограничиваться концепцией "link first"
3. В "предложении" может быть сразу несколько ссылок. Первичную ссылку стоит определять на моменте модерации, а не создании.

Предложение: создать метод-свалку, куда будем отправлять просто текст. Бэкенд будет парсить текст, искать ссылки и выводить их в модерку. Первичные ссылки можно будет хранить отдельно для дальнейшей дедубликации.

POST /suggestion
{
  "text": "Привет, вот крутой проект: https://github.com/{owner}/{project}. За неделю там 100500 звёздочек, давайте запустим его в PHP Digest?"
}

или

POST /suggestion
{
  "text": "Интересное наблюдение: в PHP 100500 стандартных функций, объекты работают быстрее массивов, а ресурсы и вовсе никто не использует."
}

---

Для частных случаев можно сделать предложение и с отдельной ссылкой

POST /suggestion
{
  "url": "https://github.com/{owner}/{project}"
}

или

POST /suggestion
{
  "url": "https://github.com/{owner}/{project}",
  "comment": "Мой крутой проект, поделитесь со всеми"
}

---

Еще в метод не заложен возможный источик.

Предлагаю сделать что-то вроде "гибкого" источника:

{
  "author": {
    "source": "telegram",
    "id": "@xepozz"
  }
}

{
  "author": {
    "source": "chrome-extension",
    "id": "@xepozz"
  }
}

{
  "author": {
    "source": "phpdigest.ru",
    "id": "Anonymous"
  }
}

{
  "author": {
    "source": "email",
    "id": "[email protected]"
  }
}

[samdark]

С источником идея норм, а вот отвязываться от ссылок, как по мне, не стоит. Проблему нескольких ссылок можно вполне решить регламентом "одна ссылка - один запрос". Иначе мы огребём на разборе freeform-текста, где не ясно, что к какой ссылке относится.