GetNinjas

Buscar serviços

Busca serviços e profissionais no marketplace por palavra-chave, para quem quer encontrar ou contratar alguém para um serviço — limpeza, reformas e reparos, assistência técnica (geladeira, máquina de lavar, ar-condicionado), elétrica, encanamento, pintura, fotografia, jardinagem. O termo de busca é o nome do serviço: para 'preciso consertar minha geladeira', o termo correspondente é 'conserto de geladeira'. Com o `cep` da pessoa, os resultados vêm filtrados por quem atende a região dela; sem cep

Navegar categorias

Lista as categorias de serviço do marketplace, ou detalha uma categoria pelo slug. Responde a "o que vocês oferecem?" e é a origem dos slugs de categoria que servem para restringir uma busca.

Ver detalhes do serviço

Detalha um serviço: descrição, preço, modalidade, prestador, o que está incluído, restrições e as condições gerais, que são o texto que a pessoa precisa aceitar para contratar. O serviço é identificado pelo slug.

Listar pedidos

Lista os pedidos da conta vinculada, do mais recente para o mais antigo. Responde a 'quais são meus pedidos?', 'o que eu contratei?' e 'quanto paguei?'. Devolve, por pedido, o orderId (UUID), o código exibido (displayId), o status, o valor total em centavos e a data. É um resumo por pedido, sem itens, agendamento nem endereço.

Contratar serviço

Contrata um serviço: valida o carrinho, cria o pedido e devolve o link de pagamento. Cria um pedido real e cobrável no nome da pessoa, e depende da confirmação dela sobre serviço, preço, data, período e endereço, além do aceite das condições gerais do serviço. Serviços presenciais (in_person) exigem scheduledDate, scheduledWindow e address; o CEP do endereço é validado contra a cobertura do prestador e endereços fora dela são recusados. O link devolvido leva ao site, onde a pessoa entra na conta

Acompanhar pedido

Detalha um pedido: status, itens, valor, agendamento e a localidade do serviço (bairro, cidade e UF). Responde a 'onde está meu pedido?' e 'o que eu contratei nesse pedido?'. O identificador é o orderId (UUID) ou o displayId, que tem o formato 12345-67890-11111 e é o código que a pessoa vê.