Paginação

Todo endpoint de listagem (GET /v1/customers, GET /v1/products, GET /v1/products/:id/offers, GET /v1/checkouts) retorna o mesmo envelope e pagina do mesmo jeito.

Objeto de lista

{
  "object": "list",
  "data": [
    { "id": "cus_2f...", "object": "customer", "...": "..." },
    { "id": "cus_1a...", "object": "customer", "...": "..." }
  ],
  "has_more": true,
  "next_cursor": "cus_1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
}

string

Sempre "list".

array

A página de resultados, mais recentes primeiro (por data de criação).

boolean

true quando existe pelo menos mais um registro depois desta página.

string | null

O ID a passar como starting_after na próxima página. null quando has_more é false.

Parâmetros de query

integer

padrão:"20"

Quantos registros retornar, de 1 a 100.

string

Um ID de recurso de uma página anterior (normalmente o next_cursor). A resposta começa no registro imediatamente após ele. Um ID malformado ou que não pertence à sua conta retorna 400 com code: "invalid_cursor".

Percorrendo todos os registros

async function* allCustomers(token) {
  let cursor;
  do {
    const url = new URL("https://api.moneydev.com.br/v1/customers");
    url.searchParams.set("limit", "100");
    if (cursor) url.searchParams.set("starting_after", cursor);

    const res = await fetch(url, {
      headers: { Authorization: `Bearer ${token}` },
    });
    const page = await res.json();

    yield* page.data;
    cursor = page.next_cursor;
  } while (cursor);
}

Introdução

Conta

Clientes

Produtos

Ofertas

Checkouts

Objeto de lista

Parâmetros de query

Percorrendo todos os registros

​Objeto de lista

​Parâmetros de query

​Percorrendo todos os registros

Objeto de lista

Parâmetros de query

Percorrendo todos os registros