App Kóden

GET/api/integrations/v1/context

Contexto da integracao

Retorna empresa, integracao autenticada e unidades disponiveis para a chave.

Escopo: booking:read
Query params: Nenhum parametro obrigatorio.
Payload: Nao se aplica.
Erros: 401 chave invalida; 403 escopo ausente.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/context

json

{
  "company_id": "COMPANY_ID",
  "integration": {
    "id": "INTEGRATION_ID",
    "name": "Chatbot atendimento",
    "scopes": ["booking:read", "booking:write"]
  },
  "units": [{ "id": "UNIT_ID", "name": "Unidade Centro" }]
}

GET/api/integrations/v1/units

Listar unidades

Lista as unidades que a API Key pode acessar.

Escopo: booking:read
Query params: Nenhum parametro obrigatorio.
Payload: Nao se aplica.
Erros: 401 chave invalida; 403 escopo ausente.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/units

json

[
  { "id": "UNIT_ID", "name": "Unidade Centro", "slug": "centro" }
]

GET/api/integrations/v1/services

Listar servicos

Lista servicos ativos de uma unidade, opcionalmente filtrados por profissional.

Escopo: booking:read
Query params: unit_id obrigatorio; barber_id opcional.
Payload: Nao se aplica.
Erros: 400 parametro invalido; 403 unidade nao permitida; 404 unidade inexistente.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/services

json

[
  {
    "id": "SERVICE_ID",
    "name": "Corte masculino",
    "duration_minutes": 50,
    "price": "120.00"
  }
]

GET/api/integrations/v1/barbers

Listar profissionais

Lista profissionais ativos da unidade, opcionalmente filtrados por servico.

Escopo: booking:read
Query params: unit_id obrigatorio; service_id opcional.
Payload: Nao se aplica.
Erros: 400 parametro invalido; 403 unidade nao permitida; 404 unidade inexistente.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/barbers

json

[
  { "id": "BARBER_ID", "name": "Nicolas", "services": ["SERVICE_ID"] }
]

GET/api/integrations/v1/availability

Consultar disponibilidade

Retorna horarios disponiveis considerando expediente, profissional, servico e conflitos.

Escopo: booking:read
Query params: unit_id, service_id e date obrigatorios; barber_id opcional.
Payload: Nao se aplica.
Erros: 400 data invalida; 403 unidade nao permitida; 404 servico ou profissional indisponivel.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/availability

json

{
  "date": "2026-07-10",
  "slots": [
    {
      "starts_at": "2026-07-10T10:00:00",
      "ends_at": "2026-07-10T10:50:00",
      "time": "10:00",
      "barber_id": "BARBER_ID",
      "price": "120.00",
      "duration_minutes": 50
    }
  ]
}

POST/api/integrations/v1/appointments

Criar agendamento

Cria um agendamento com snapshots operacionais e idempotencia por external_reference.

Escopo: booking:write
Query params: Nenhum parametro de query.
Payload: Veja exemplo abaixo.
Erros: 400 payload invalido; 403 escopo/unidade; 409 conflito de horario; 422 campos obrigatorios.

curl

curl -X POST -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/appointments

json

{
  "unit_id": "UNIT_ID",
  "service_id": "SERVICE_ID",
  "barber_id": "BARBER_ID",
  "starts_at": "2026-07-10T10:00:00",
  "client": {
    "name": "Cliente Exemplo",
    "phone": "+5511999999999",
    "email": "cliente@example.com"
  },
  "notes": "Cliente veio pelo chatbot",
  "external_reference": "whatsapp-5511999999999-20260710"
}

json

{
  "appointment_id": "APPOINTMENT_ID",
  "status": "agendado",
  "starts_at": "2026-07-10T10:00:00",
  "ends_at": "2026-07-10T10:50:00",
  "confirmation_message": "Seu horario foi registrado com sucesso."
}

GET/api/integrations/v1/appointments/{appointment_id}

Consultar agendamento

Retorna um agendamento criado ou acessivel pela integracao.

Escopo: booking:read
Query params: appointment_id no path.
Payload: Nao se aplica.
Erros: 401 chave invalida; 403 escopo ausente; 404 agendamento nao encontrado.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/appointments/APPOINTMENT_ID

json

{
  "appointment_id": "APPOINTMENT_ID",
  "status": "agendado",
  "client": { "name": "Cliente Exemplo", "phone": "5511999999999" }
}

POST/api/integrations/v1/appointments/{appointment_id}/cancel

Cancelar agendamento

Cancela um agendamento permitido para a integracao.

Escopo: booking:write
Query params: appointment_id no path.
Payload: { "reason": "Cliente solicitou cancelamento" }
Erros: 403 escopo ausente; 404 agendamento nao encontrado.

curl

curl -X POST -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/appointments/APPOINTMENT_ID/cancel

json

{ "reason": "Cliente solicitou cancelamento" }

json

{ "appointment_id": "APPOINTMENT_ID", "status": "cancelado" }

POST/api/integrations/v1/appointments/{appointment_id}/reschedule

Reagendar agendamento

Move um agendamento para um novo horario sem alterar regras de calculo.

Escopo: booking:write
Query params: appointment_id no path.
Payload: { "starts_at": "2026-07-11T14:00:00", "reason": "Cliente pediu outro horario" }
Erros: 403 escopo ausente; 404 agendamento nao encontrado; 409 novo horario indisponivel.

curl

curl -X POST -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/appointments/APPOINTMENT_ID/reschedule

json

{ "starts_at": "2026-07-11T14:00:00", "reason": "Cliente pediu outro horario" }

json

{ "appointment_id": "APPOINTMENT_ID", "status": "agendado", "starts_at": "2026-07-11T14:00:00" }

Abrindo App Kóden...Preparando sua experiência.

GET/api/integrations/v1/context

Contexto da integracao

Retorna empresa, integracao autenticada e unidades disponiveis para a chave.

Escopo: booking:read
Query params: Nenhum parametro obrigatorio.
Payload: Nao se aplica.
Erros: 401 chave invalida; 403 escopo ausente.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/context

json

{
  "company_id": "COMPANY_ID",
  "integration": {
    "id": "INTEGRATION_ID",
    "name": "Chatbot atendimento",
    "scopes": ["booking:read", "booking:write"]
  },
  "units": [{ "id": "UNIT_ID", "name": "Unidade Centro" }]
}

GET/api/integrations/v1/units

Listar unidades

Lista as unidades que a API Key pode acessar.

Escopo: booking:read
Query params: Nenhum parametro obrigatorio.
Payload: Nao se aplica.
Erros: 401 chave invalida; 403 escopo ausente.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/units

json

[
  { "id": "UNIT_ID", "name": "Unidade Centro", "slug": "centro" }
]

GET/api/integrations/v1/services

Listar servicos

Lista servicos ativos de uma unidade, opcionalmente filtrados por profissional.

Escopo: booking:read
Query params: unit_id obrigatorio; barber_id opcional.
Payload: Nao se aplica.
Erros: 400 parametro invalido; 403 unidade nao permitida; 404 unidade inexistente.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/services

json

[
  {
    "id": "SERVICE_ID",
    "name": "Corte masculino",
    "duration_minutes": 50,
    "price": "120.00"
  }
]

GET/api/integrations/v1/barbers

Listar profissionais

Lista profissionais ativos da unidade, opcionalmente filtrados por servico.

Escopo: booking:read
Query params: unit_id obrigatorio; service_id opcional.
Payload: Nao se aplica.
Erros: 400 parametro invalido; 403 unidade nao permitida; 404 unidade inexistente.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/barbers

json

[
  { "id": "BARBER_ID", "name": "Nicolas", "services": ["SERVICE_ID"] }
]

GET/api/integrations/v1/availability

Consultar disponibilidade

Retorna horarios disponiveis considerando expediente, profissional, servico e conflitos.

Escopo: booking:read
Query params: unit_id, service_id e date obrigatorios; barber_id opcional.
Payload: Nao se aplica.
Erros: 400 data invalida; 403 unidade nao permitida; 404 servico ou profissional indisponivel.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/availability

json

{
  "date": "2026-07-10",
  "slots": [
    {
      "starts_at": "2026-07-10T10:00:00",
      "ends_at": "2026-07-10T10:50:00",
      "time": "10:00",
      "barber_id": "BARBER_ID",
      "price": "120.00",
      "duration_minutes": 50
    }
  ]
}

POST/api/integrations/v1/appointments

Criar agendamento

Cria um agendamento com snapshots operacionais e idempotencia por external_reference.

Escopo: booking:write
Query params: Nenhum parametro de query.
Payload: Veja exemplo abaixo.
Erros: 400 payload invalido; 403 escopo/unidade; 409 conflito de horario; 422 campos obrigatorios.

curl

curl -X POST -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/appointments

json

{
  "unit_id": "UNIT_ID",
  "service_id": "SERVICE_ID",
  "barber_id": "BARBER_ID",
  "starts_at": "2026-07-10T10:00:00",
  "client": {
    "name": "Cliente Exemplo",
    "phone": "+5511999999999",
    "email": "cliente@example.com"
  },
  "notes": "Cliente veio pelo chatbot",
  "external_reference": "whatsapp-5511999999999-20260710"
}

json

{
  "appointment_id": "APPOINTMENT_ID",
  "status": "agendado",
  "starts_at": "2026-07-10T10:00:00",
  "ends_at": "2026-07-10T10:50:00",
  "confirmation_message": "Seu horario foi registrado com sucesso."
}

GET/api/integrations/v1/appointments/{appointment_id}

Consultar agendamento

Retorna um agendamento criado ou acessivel pela integracao.

Escopo: booking:read
Query params: appointment_id no path.
Payload: Nao se aplica.
Erros: 401 chave invalida; 403 escopo ausente; 404 agendamento nao encontrado.

curl

curl -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/appointments/APPOINTMENT_ID

json

{
  "appointment_id": "APPOINTMENT_ID",
  "status": "agendado",
  "client": { "name": "Cliente Exemplo", "phone": "5511999999999" }
}

POST/api/integrations/v1/appointments/{appointment_id}/cancel

Cancelar agendamento

Cancela um agendamento permitido para a integracao.

Escopo: booking:write
Query params: appointment_id no path.
Payload: { "reason": "Cliente solicitou cancelamento" }
Erros: 403 escopo ausente; 404 agendamento nao encontrado.

curl

curl -X POST -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/appointments/APPOINTMENT_ID/cancel

json

{ "reason": "Cliente solicitou cancelamento" }

json

{ "appointment_id": "APPOINTMENT_ID", "status": "cancelado" }

POST/api/integrations/v1/appointments/{appointment_id}/reschedule

Reagendar agendamento

Move um agendamento para um novo horario sem alterar regras de calculo.

Escopo: booking:write
Query params: appointment_id no path.
Payload: { "starts_at": "2026-07-11T14:00:00", "reason": "Cliente pediu outro horario" }
Erros: 403 escopo ausente; 404 agendamento nao encontrado; 409 novo horario indisponivel.

curl

curl -X POST -H "X-BarberHub-Api-Key: YOUR_API_KEY" \
  https://app.kodenoficial.com.br/api/integrations/v1/appointments/APPOINTMENT_ID/reschedule

json

{ "starts_at": "2026-07-11T14:00:00", "reason": "Cliente pediu outro horario" }

json

{ "appointment_id": "APPOINTMENT_ID", "status": "agendado", "starts_at": "2026-07-11T14:00:00" }

API Reference

Contexto da integracao

Listar unidades

Listar servicos

Listar profissionais

Consultar disponibilidade

Criar agendamento

Consultar agendamento

Cancelar agendamento

Reagendar agendamento

API Reference

Contexto da integracao

Listar unidades

Listar servicos

Listar profissionais

Consultar disponibilidade

Criar agendamento

Consultar agendamento

Cancelar agendamento

Reagendar agendamento