Cadastrar

POST

/driver

Cadastra um novo motorista.

Disponível para: Revendedor e Cliente
Rate limit: 100 requisições/minuto

📌 Esta é a versão da documentação para token de Cliente.

Revendedor x Cliente

O motorista é criado no escopo do token utilizado (revendedor ou cliente).

Regras

name e cpf são obrigatórios.

Datas (birthDate, cnhExpiresAt, medicalExamExpiresAt) no formato AAAA-MM-DD. As validades são gravadas como 23:59:59 do dia informado.

cnhCategories recebe as letras das categorias (ex.: ["B", "D"]).

Erros específicos

Categoria de CNH inexistente → 500 com {"error": "Categoria de CNH <X> não encontrada"}.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200Sucesso

application/json

Bodyapplication/json

🟠400Bad request

🟠403Forbidden

🔴500Internal server error

🟠429Too Many Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cloud-services.yuv.com.br/driver' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "João da Silva",
    "cpf": "123.456.789-00",
    "identifier": "MOT-001",
    "birthDate": "1985-03-10",
    "cnh": "01234567890",
    "cnhExpiresAt": "2027-01-31",
    "cnhCategories": [
        "B",
        "D"
    ],
    "medicalExamExpiresAt": "2026-06-30"
}'

Response Example

200 - Sucesso

{
    "data": {
        "id": 12,
        "name": "João da Silva",
        "identifier": "MOT-001",
        "birthDate": "1985-03-10",
        "cnh": "01234567890",
        "cnhExpiresAt": "2027-01-31 23:59:59",
        "medicalExamExpiresAt": "2026-06-30 23:59:59",
        "cnhCategories": [
            "B",
            "D"
        ]
    }
}

Modificado em 2026-10-02 19:54:11

Cadastrar

Revendedor x Cliente#

Regras#

Erros específicos#

Requisição

Respostas

Revendedor x Cliente

Regras

Erros específicos