POST/api/suppliers

Criar Fornecedor

Cria um novo fornecedor

Access Token

Para realizar requisições GET, POST, PUT, DELETE e PATCH nos endpoints da API você precisa de uma chave de autorização. Chamamos essa chave de accessToken.

Para ter acesso ao accessToken, é necessário que o usuário master da licença efetue a liberação deste pela interface do ImageMais Clinic. O accessToken tem validade de 1 hora.

Headers

AuthorizationOBRIGATÓRIO
Tipo:string
Token de autenticação no formato Bearer {accessToken}
Content-TypeOBRIGATÓRIO
Tipo:application/json
Tipo de conteúdo (application/json)

Parâmetros

nameOBRIGATÓRIO
Tipo:string
Nome do fornecedor

Este parâmetro representa o nome do fornecedor que será criado. É um parâmetro obrigatório que deve ser enviado no corpo da requisição.

Exemplo:

"name": "Black clover"

Atenção: Caso o parâmetro name não seja passado ou esteja vazio, a API retornará um erro 400 Bad Request com a mensagem: "name should not be empty".

Request URL

https://api-dev.imagemais.com/api/suppliers
curl -X 'POST' \
  'https://api-dev.imagemais.com/api/suppliers' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer string' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Black clover"
}'
{
  "name": "Black clover"
}
{
  "name": "Black clover"
}

Respostas

{
  "id": 5,
  "name": "Black clover",
  ...
{
  "id": 5,
  "name": "Black clover",
  "accountId": 1,
  "createdAt": "2025-12-10T14:48:09.912Z",
  "updatedAt": "2025-12-10T14:48:09.912Z",
  "deletedAt": null
}
{
  "message": [
    "name should not be empty"
  ...
{
  "message": [
    "name should not be empty"
  ],
  "error": "Bad Request"
}
{
  "statusCode": 401,
  "message": "invalid token"
  ...
{
  "statusCode": 401,
  "message": "invalid token"
}
{
  "statusCode": 401,
  "message": "jwt expired"
  ...
{
  "statusCode": 401,
  "message": "jwt expired"
}
{
  "statusCode": 500,
  "message": "Internal server error"
  ...
{
  "statusCode": 500,
  "message": "Internal server error"
}