search

facundobatista / kilink

A next generation pastebin
GNU General Public License v3.0
25 stars 30 forks source link

API v2.0 #156

Closed sofide closed 4 months ago

sofide commented 4 months ago

Copio las notas de las decisiones que tomamos sobre la api v2.0:

/linkode POST -> crea un nodo raiz
- toma:
    - content
    - text_type [opt]
- devuelve:
    - linkode_metadata
        - linkode_id
        - root_id (self)
        - linkode_url
        - root_url

/linkode/id/
    - POST -> Crea un hijo de ese id
        - toma lo mismo que /linkode/
        - devuelve lo mismo que /linkode/

    - GET -> devuelve details de ese id
        - devuelve lo mismo que lo otro + extra info:
            - content
            - text_type
            - timestamp, etc....

/tree/id/ GET solo funciona con id de root (sino 404)
    - devuelve:
        - estructura de arbol, cada nodo con su metadata:
            - linkode_id
            - timestamp

NO HAY PUT en ningun endpoint. Todas las entidades son inmutables, para cambios crear uno nuevo.