Que content type espera o endpoint de criação?

application/x-www-form-urlencoded, com bearer token no header Authorization.

Onde está a documentação completa?

A documentação técnica e os recursos de integração, incluindo uma especificação OpenAPI e uma coleção Postman, são disponibilizados diretamente a parceiros aprovados durante o onboarding.

A especificação OpenAPI é pública?

Não. Faz parte dos nossos recursos privados para parceiros e é partilhada com parceiros aprovados, juntamente com uma coleção Postman, para acelerar a integração.

PROGRAMADORES

Integrar a API de Marketplace de Serviços

Uma API REST pequena e previsível: obter um token, criar um pedido, validar duplicados. A documentação técnica e os recursos de integração são disponibilizados a parceiros aprovados.

O que é a Fixando?

A API de Marketplace de Serviços da Fixando é uma API REST protegida com OAuth 2.0 client credentials, com endpoints para criar pedidos de serviço e validar duplicados. É privada, e os recursos técnicos são partilhados apenas com parceiros aprovados.

Autenticação

Peça um bearer token ao endpoint OAuth com o grant client credentials e envie-o no header Authorization de cada chamada. Os tokens têm validade curta, pelo que deve fazer cache e renovação no servidor.

POST /oauth/token - grant client credentials
POST /v1/request/create - criar pedido de serviço
POST /v1/request/validate - validar duplicados
A documentação técnica e os recursos de integração são disponibilizados a parceiros aprovados

Criar um pedido

Envie parâmetros form-encoded com a categoria, a localização e a descrição da necessidade. Os parceiros aprovados podem também enviar áudio em base64 em vez de texto. Valide sempre primeiro se o seu fluxo pode gerar submissões repetidas.

Boas práticas

Mantenha as credenciais de parceiro no servidor, nunca no browser nem em bundles móveis. Trate os limites de utilização com backoff exponencial, registe os identificadores devolvidos e considere a validação parte do fluxo normal e não um extra opcional.

Perguntas frequentes

Que content type espera o endpoint de criação?: application/x-www-form-urlencoded, com bearer token no header Authorization.
Onde está a documentação completa?: A documentação técnica e os recursos de integração, incluindo uma especificação OpenAPI e uma coleção Postman, são disponibilizados diretamente a parceiros aprovados durante o onboarding.
A especificação OpenAPI é pública?: Não. Faz parte dos nossos recursos privados para parceiros e é partilhada com parceiros aprovados, juntamente com uma coleção Postman, para acelerar a integração.

Comece a sua integração

Contacte-nos para iniciar uma integração de parceiro. A nossa equipa analisa cada integração individualmente e discutirá consigo os detalhes técnicos.

Pedir acesso à API

Fale-nos do seu produto e de como gostaria de integrar a Fixando. A nossa equipa analisa cada integração individualmente e entrará em contacto para discutir o seu caso de uso e os requisitos técnicos.