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.
API REST, OAuth 2.1, tokens personales, webhooks firmados, OpenAPI y SDKs oficiales en un único punto de entrada.
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"
}
}
El portal reúne el camino mínimo para probar la API sin ocultar las reglas que importan en producción.
Usá un token personal para scripts propios u OAuth 2.1 con PKCE para una aplicación que conectarán otros usuarios.
Separá lectura y escritura de perfil, calendarios, eventos, tareas, contactos, disponibilidad y reservas.
Enviá el token como Bearer y conservá el Request ID para poder diagnosticar cada operación.
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"
require __DIR__ . '/PietroCalClient.php';
use PietroCal\Sdk\PietroCalClient;
$client = new PietroCalClient(
getenv('PIETROCAL_API_TOKEN')
);
$profile = $client->profile();
print_r($profile['data']);
import { PietroCalClient } from './pietrocal-client.js';
const client = new PietroCalClient({
token: process.env.PIETROCAL_API_TOKEN
});
const profile = await client.profile();
console.log(profile.data);
import os
from pietrocal_client import PietroCalClient
client = PietroCalClient(
os.environ["PIETROCAL_API_TOKEN"]
)
profile = client.profile()
print(profile.data)
Elegí el mecanismo según quién usa la credencial y mantené los permisos acotados desde el primer request.
Para scripts, automatizaciones internas y herramientas controladas por el mismo propietario.
Prefijopc_live_
Para aplicaciones que deben pedir autorización a distintos usuarios mediante PKCE y scopes.
Authorization Code + PKCECalendarios, suscripciones, eventos y recordatorios con permisos de lectura o escritura separados.
Contactos CardDAV expuestos mediante la API común, respetando el propietario y las libretas autorizadas.
Links públicos, ventanas disponibles y consultas free/busy para construir flujos de coordinación.
Solicitudes, estados y operaciones de reservas conectadas con el calendario real del recurso.
Agenda, contactos, disponibilidad, OAuth y Webhooks con scopes, endpoints, tratamiento de errores y lista de verificación.
Listá calendarios y creá eventos idempotentes con la API de PietroCal sin duplicar operaciones ante cortes de red.
Abrir guía Sincronizar contactosLeé y actualizá contactos de PietroCal mediante la API, conservando libreta, URI y ETag para detectar ediciones concurrentes.
Abrir guía Encontrar un horario libreConsultá free/busy en PietroCal y convertí un horario libre en un evento idempotente dentro del calendario autorizado.
Abrir guíaLa documentación no se limita al caso feliz: explica cómo reconciliar operaciones ambiguas, verificar entregas y diagnosticar solicitudes.
Las creaciones admiten Idempotency-Key. Una repetición segura reproduce la respuesta sin duplicar el recurso.
Los headers informan ráfaga, cuota compartida y presupuesto individual de la credencial.
Cada respuesta publica un identificador para relacionar errores, actividad y soporte técnico.
Las entregas llevan firma HMAC, identificadores estables, reintentos y un historial auditable.
Flujos completos con scopes, orden de llamadas, ejemplos, errores y checklist.
Ver guías Cambios y versionadoRevisá novedades, compatibilidad y deprecaciones antes de actualizar una integración.
Ver cambios Errores y diagnósticoDecidí cuándo corregir, esperar, reintentar o reconciliar usando Request ID.
Resolver errores Referencia interactivaExplorá endpoints, scopes, cuerpos y respuestas desde Swagger UI.
Abrir Swagger OpenAPI 3.1Descargá el contrato para validar o generar clientes.
Ver YAML SDKs oficialesClientes PHP, JavaScript y Python con idempotencia y reintento seguro.
Ver SDKs OAuth QuickstartFlujo Authorization Code con PKCE, refresh rotatorio y revocación.
Leer guía Guía de integraciónContratos de scopes, cuotas, errores, webhooks e idempotencia.
Leer documentación Administrar credencialesCreá tokens y aplicaciones OAuth desde tu cuenta PietroCal.
Ir a PietroCalLos límites, el consumo y la actividad de cada token se administran desde Integraciones y API.