{
  "info": {
    "_postman_id": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
    "name": "API Weblyrics",
    "description": "Collection oficial da **API Weblyrics** (Chord API).\n\nUm único endpoint `POST {{baseUrl}}/v1` com body `{ \"call\", \"data\" }`.\n\n**Auth canônica:** header `x-api-key` com valor `wlk_…` (variável `{{wl_api_key}}`). A chave **nunca** vai no body.\n\nPortal: https://weblyrics.com.br/developers\nOpenAPI: pacote `@wl/open-api-contract` (`openapi/openapi.yaml`).\n\nCalls: `instruments.list`, `instruments.get`, `chords.search`, `universe.songs.search`, `universe.artists.search`.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "version": "0.1.4"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.weblyrics.com.br"
    },
    {
      "key": "wl_api_key",
      "value": "",
      "description": "Sua chave Chord API (`wlk_…`). Preencha localmente — nunca versionar plaintext."
    },
    {
      "key": "sample_instrument_x_id",
      "value": "11111111-1111-4111-8111-111111111111",
      "description": "UUID de exemplo (substitua por um id real de instruments.list)."
    }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "x-api-key",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{wl_api_key}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "instruments.list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"call\": \"instruments.list\",\n  \"data\": {\n    \"limit\": 50\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": "{{baseUrl}}/v1",
        "description": "Lista instrumentoX do sistema (paginado). Alinhado ao exemplo OpenAPI `instrumentsList`."
      },
      "response": []
    },
    {
      "name": "instruments.get",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"call\": \"instruments.get\",\n  \"data\": {\n    \"instrument_x_id\": \"{{sample_instrument_x_id}}\"\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": "{{baseUrl}}/v1",
        "description": "Obtém um instrumentoX pelo UUID. Use um `instrument_x_id` retornado por `instruments.list`."
      },
      "response": []
    },
    {
      "name": "chords.search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"call\": \"chords.search\",\n  \"data\": {\n    \"name\": \"Am\",\n    \"format\": \"json\",\n    \"limit\": 20\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": "{{baseUrl}}/v1",
        "description": "Pesquisa no dicionário de acordes. Exemplo OpenAPI: acorde Am. Opcional: `include` (`meta`, `diagram_svg`, `tablature`)."
      },
      "response": []
    },
    {
      "name": "universe.songs.search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"call\": \"universe.songs.search\",\n  \"data\": {\n    \"q\": \"boemia\",\n    \"format\": \"json\"\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": "{{baseUrl}}/v1",
        "description": "Pesquisa versões publicadas no Universo. Exemplo OpenAPI: q=boemia."
      },
      "response": []
    },
    {
      "name": "universe.artists.search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"call\": \"universe.artists.search\",\n  \"data\": {\n    \"name_prefix\": \"To\"\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": "{{baseUrl}}/v1",
        "description": "Pesquisa artistas no Universo. Exemplo OpenAPI: name_prefix=To."
      },
      "response": []
    }
  ]
}