Integracionplanok API REST

What authentication does the Planok GCI API use?

The spec defines several apiKey-style schemes: APIKey (query parameter 'apikey'), APIKeyPublic (header 'xApiKeyPublic'), JWT (Authorization header), XAPIKey (header 'X-API-KEY'), CognitoJWT (header 'Token'), NotificacionPush (query 'codigoAplicacion'), and Planok (query 'sharedSecret'). Endpoints declare which scheme they require, so use the one your client application is provisioned for. Through Jentic, all of these credentials are held in your encrypted Jentic One instance.

Can I create online property reservations through this API?

Yes. The 'Reserva En Línea' tag groups the online-reservation endpoints, which create and read reservations against project units. Combine these with the channel-specific endpoints (Webpay, Visanet, Iconstruye, Pok Pagos) to take payment alongside the reservation.

What are the rate limits for the Planok GCI API?

The OpenAPI specification does not encode explicit rate limits. Owner-onboarding and reservation endpoints are typically driven by user actions, so design around per-event calls, paginate any list endpoints, and back off on 429 responses returned by the gateway.

How do I register a property owner through Jentic?

Install with pip install jentic, then run the search-load-execute flow with the query 'register a Planok property owner'. Jentic returns the operation backed by POST /guia/registro-inicial-propietario; the agent supplies the owner identifier and any required project context.

Can the API send WhatsApp notifications?

Yes. The 'Whatsapp' tag groups endpoints that trigger WhatsApp notifications on reservation events. They are intended to keep buyers updated on installments and document state on a channel that dominates messaging in many Latin American markets.

Can I limit what my agent is allowed to do with the Planok GCI REST API?

Yes. Because you run Jentic One yourself, your own rules decide which Planok operations and API keys the agent may use, so you can grant just the endpoints a task needs, such as registering an owner via /guia/registro-inicial-propietario or checking owner status, and withhold the rest. Sensitive actions like password changes on /guia/cambiar-password stay off the agent's list unless you explicitly add them, and you can likewise scope whether it may trigger payment channels such as Webpay, Visanet, or Iconstruye. The keys are bound to the right query or header parameter at execution time, so the agent only ever calls the operations you allow.