📁 .scribe/                     (arquivos intermediários)
   ├── 📄 intro.md
   ├── 📄 auth.md
   ├── 📁 endpoints/
   └── 📁 endpoints.cache/

📁 resources/views/scribe/       (views Blade)
   └── 📄 index.blade.php

📁 public/vendor/scribe/         (assets CSS/JS)
   ├── 📁 css/
   └── 📁 js/

📁 storage/app/private/scribe/   (exportações)
   ├── 📄 collection.json
   └── 📄 openapi.yaml

/**
 * @group Autenticação
 *
 * APIs para autenticação de usuários (login, registro, logout).
 */

@authenticated    // Usado em 7 endpoints
@unauthenticated  // Usado em 2 endpoints

@urlParam     // Usado em 3 endpoints (show, update, destroy)
@queryParam   // Usado em 1 endpoint (index de produtos)
@bodyParam    // Usado em 4 endpoints (login, register, store, update)

@response     // Usado com múltiplos status codes

curl --request POST \
  --get "http://localhost/api/v1/login" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --data "{
    \"email\": \"produtor@agrsis.com.br\",
    \"password\": \"senha123\"
}"

const url = new URL("http://localhost/api/v1/login");

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "email": "produtor@agrsis.com.br",
    "password": "senha123"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'http://localhost/api/v1/login';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'email' => 'produtor@agrsis.com.br',
            'password' => 'senha123',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'http://localhost/api/v1/login'
payload = {
    "email": "produtor@agrsis.com.br",
    "password": "senha123"
}
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

{
    "variable": [
        {
            "id": "baseUrl",
            "key": "baseUrl",
            "type": "string",
            "name": "string",
            "value": "http://localhost"
        }
    ],
    "info": {
        "name": "AgrSis API",
        "_postman_id": "9350df64-f6dc-4ddc-8749-6b60d42f7ea7",
        "description": "API da plataforma AgrSis - Sistema de Licitação Eletrônica",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "item": [
        {
            "name": "Autenticação",
            "description": "APIs para autenticação de usuários",
            "item": [
                {
                    "name": "Login",
                    "request": {
                        "url": "{{baseUrl}}/api/v1/login",
                        "method": "POST",
                        "body": {
                            "mode": "raw",
                            "raw": "{\"email\":\"produtor@agrsis.com.br\",\"password\":\"senha123\"}"
                        }
                    },
                    "response": [...]
                }
            ]
        }
    ]
}

openapi: 3.0.3
info:
  title: 'AgrSis API'
  description: 'API da plataforma AgrSis - Sistema de Licitação Eletrônica'
  version: 1.0.0
servers:
  - url: 'http://localhost'
tags:
  - name: Autenticação
    description: "APIs para autenticação de usuários"
  - name: Produtos
    description: "APIs para gerenciamento de produtos"
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: 'Você pode obter seu token de autenticação fazendo login'
security:
  - default: []
paths:
  /api/v1/login:
    post:
      summary: Login
      operationId: login
      description: 'Realiza autenticação do usuário e retorna um token de acesso.'
      responses:
        200:
          description: ''
          content:
            application/json:
              schema:
                type: object
                example:
                  success: true
                  message: 'Login realizado com sucesso'
                  data:
                    user: {...}
                    token: '1|abcdefghijklmnopqrstuvwxyz123456789'