Criar links em lote

POSThttps://api.curtei.com/v1/links/bulk

POST /v1/links/bulk: até 1.000 links por chamada com resultado por item, ou até 50.000 em segundo plano. Escopo: links:write.

Mande { "links": [ {...}, {...} ] }; cada item aceita os mesmos campos do POST /links. Um item com erro não impede os outros.

Até 1.000 itens: resposta na hora

Resposta 207 Multi-Status com um resultado por item, na mesma ordem (index):

{
  "summary": {
    "total": 2,
    "created": 1,
    "failed": 1
  },
  "results": [
    {
      "index": 0,
      "status": 201,
      "link": {
        "id": "...",
        "short_url": "https://l.curtei.com/aB3xK9"
      }
    },
    {
      "index": 1,
      "status": 400,
      "error": {
        "code": "invalid_url",
        "message": "...",
        "details": {
          "reason": "scheme_not_allowed"
        }
      }
    }
  ]
}

De 1.001 a 50.000 itens: em segundo plano

  • A resposta é 202 com { "id", "status": "pending", "total", "status_url" }.
  • Consulte GET /links/bulk/{id} (processed, created, failed) até status ser done.
  • Aí results_url é um endereço assinado, válido por 24 h e sem token, com um resultado por linha (NDJSON).

Cada destino passa pela checagem de segurança, então o lote tem um teto de URLs de destino (contando regras e variantes): 3.000 na resposta imediata e 75.000 em segundo plano. Acima disso, 400 com details.destinations e details.max.