List the rounds waiting on a person

curl --request GET \
  --url https://api.example.com/v1/refinements/rounds \
  --header 'Authorization: Bearer <token>'

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/refinements/rounds"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/v1/refinements/rounds', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "items": [
    {
      "roundId": "2f7c1b93-4a5e-4d6f-8b0c-1e3a5c7d9f2b",
      "sessionId": "6b9f6d2e-1c3a-4f5b-9d7e-2a8c4e6f0b1d",
      "repository": "/Users/dana/repos/midaz",
      "itemCount": 4
    }
  ],
  "limit": 25
}

{
  "code": "NRY-0002",
  "title": "Session not found",
  "message": "No session with id 6b9f6d2e-1c3a-4f5b-9d7e-2a8c4e6f0b1d exists on this host."
}

{
  "code": "NRY-0002",
  "title": "Session not found",
  "message": "No session with id 6b9f6d2e-1c3a-4f5b-9d7e-2a8c4e6f0b1d exists on this host."
}

List the rounds waiting on a person

The rounds standing on the consent surface, newest first. It is the recovery road for a client that was not attached when refinement-proposed went out — a round proposed by last night’s scheduled fire is answered the next morning, and an announcement nobody heard must not be the only way to find it.

A round is NEVER expired by the boot-recovery pass, unlike a permission or a question: nothing is blocked behind it, so a host restarting leaves it exactly where it was.

GET

/

v1

/

refinements

/

rounds

List the rounds waiting on a person

curl --request GET \
  --url https://api.example.com/v1/refinements/rounds \
  --header 'Authorization: Bearer <token>'

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/refinements/rounds"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/v1/refinements/rounds', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "items": [
    {
      "roundId": "2f7c1b93-4a5e-4d6f-8b0c-1e3a5c7d9f2b",
      "sessionId": "6b9f6d2e-1c3a-4f5b-9d7e-2a8c4e6f0b1d",
      "repository": "/Users/dana/repos/midaz",
      "itemCount": 4
    }
  ],
  "limit": 25
}

{
  "code": "NRY-0002",
  "title": "Session not found",
  "message": "No session with id 6b9f6d2e-1c3a-4f5b-9d7e-2a8c4e6f0b1d exists on this host."
}

{
  "code": "NRY-0002",
  "title": "Session not found",
  "message": "No session with id 6b9f6d2e-1c3a-4f5b-9d7e-2a8c4e6f0b1d exists on this host."
}

Autorizações

Authorization

string

header

obrigatório

Enforced on every transport, with no exempt operation. A person's request must carry a JWT issued by the configured identity provider, which the host verifies itself against that issuer's key set: signature, issuer, expiry, and the person and organisation it names. Requests without a valid one receive 401 NRY-0011 — except a request with no token on a laptop's socket from the OS user the kernel names as the host's own, which is that machine's user.

Parâmetros de consulta

status

enum<string>

padrão:pending

Which rounds to list. pending is the default and the one a client draws an affordance from; answered is the audit of rounds already decided.

Opções disponíveis:

pending,

answered

cursor

string

Opaque pagination cursor from a previous page's nextCursor or prevCursor.

Maximum string length: 1024

limit

integer

padrão:25

Maximum items per page.

Intervalo obrigatório: 1 <= x <= 100

Resposta

One page of rounds.

One page of rounds waiting on a person.

items

object[]

obrigatório

Show child attributes

limit

integer

obrigatório

Intervalo obrigatório: x >= 1

nextCursor

string