Saltar al contenido
Portal para desarrolladores

Construí sobre PietroCal sin empezar de cero.

API REST, OAuth 2.1, tokens personales, webhooks firmados, OpenAPI y SDKs oficiales en un único punto de entrada.

REST + JSON OAuth 2.1 + PKCE Webhooks HMAC OpenAPI 3.1
GET /api/v1/me_app.php
HTTP/1.1 200 OK
X-Request-ID: req_01H...
X-RateLimit-Remaining: 598
X-PietroCal-Quota-Remaining: 9,742

{
  "success": true,
  "data": {
    "user": { "name": "Pablo" },
    "workspace": "Estudio Norte"
  }
}
Inicio rápido

De una credencial a la primera respuesta en cuatro pasos.

El portal reúne el camino mínimo para probar la API sin ocultar las reglas que importan en producción.

01

Elegí cómo autorizar

Usá un token personal para scripts propios u OAuth 2.1 con PKCE para una aplicación que conectarán otros usuarios.

02

Pedí sólo los scopes necesarios

Separá lectura y escritura de perfil, calendarios, eventos, tareas, contactos, disponibilidad y reservas.

03

Hacé tu primera solicitud

Enviá el token como Bearer y conservá el Request ID para poder diagnosticar cada operación.

04

Protegé las creaciones

En POST persistentes, usá Idempotency-Key o los SDKs oficiales para evitar duplicados ante un corte de red.

export PIETROCAL_API_TOKEN="pc_live_TU_TOKEN"

curl -sS "https://pietrocal.com/api/v1/me_app.php" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $PIETROCAL_API_TOKEN"

Autenticación

Una integración propia y una aplicación externa no necesitan el mismo acceso.

Elegí el mecanismo según quién usa la credencial y mantené los permisos acotados desde el primer request.

Token personal

Para scripts, automatizaciones internas y herramientas controladas por el mismo propietario.

Prefijo pc_live_

OAuth 2.1

Para aplicaciones que deben pedir autorización a distintos usuarios mediante PKCE y scopes.

Authorization Code + PKCE
Recursos disponibles

La misma API para agenda, contactos, disponibilidad y reservas.

Agenda

Calendarios, suscripciones, eventos y recordatorios con permisos de lectura o escritura separados.

Contactos

Contactos CardDAV expuestos mediante la API común, respetando el propietario y las libretas autorizadas.

Disponibilidad

Links públicos, ventanas disponibles y consultas free/busy para construir flujos de coordinación.

Reservas

Solicitudes, estados y operaciones de reservas conectadas con el calendario real del recurso.

Preparada para producción

Los fallos de red, los reintentos y los límites forman parte del contrato.

La documentación no se limita al caso feliz: explica cómo reconciliar operaciones ambiguas, verificar entregas y diagnosticar solicitudes.

Idempotencia durable

Las creaciones admiten Idempotency-Key. Una repetición segura reproduce la respuesta sin duplicar el recurso.

Límites visibles

Los headers informan ráfaga, cuota compartida y presupuesto individual de la credencial.

Trazabilidad por Request ID

Cada respuesta publica un identificador para relacionar errores, actividad y soporte técnico.

Webhooks verificables

Las entregas llevan firma HMAC, identificadores estables, reintentos y un historial auditable.

PietroCal API

Creá la credencial, elegí los scopes y empezá a integrar.

Los límites, el consumo y la actividad de cada token se administran desde Integraciones y API.

Administrar integraciones