interverse/Docs/getting-started.md
2022-10-12 06:15:39 -04:00

1.3 KiB

Getting started

Create your interverse file

This file is essentially your 'listing'.

  1. Grab the example file or modify the Libre Solutions Network one.
  2. Make your changes, feel free to reference the format
  3. Ensure that the file is formatted as valid JSON.
    Any errors will fail completely.

Getting online

Option A (ideal)

  • You must serve valid JSON from /.well-known/interverse
  • The header access-control-allow-origin * must also be added.

Option B (simple)

  • Serve valid JSON from either:

    • /.well-known/interverse
    • /interverse.json

Omitting the CORS header means that the client needs to ask a server to load the data, this can have performance impacts.

How do I see my listing?

Interverse is a fully-decentralized system. You can setup your instance or preview yourself at https://libresolutions.network/interverse?url={your.domain}.

Note: libresolutions.network uses a fairly long cache value when no results are returned.
If you want to see your changes reflected immediately, consider adding the CORS header.

You can also run your own instance