tray-visao-geral

Apply universal Tray API rules before resource-specific calls.

14|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tray-tecnologia/tray-api-ai-plugin --skill tray-visao-geral
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tray-visao-geral
Source: https://github.com/tray-tecnologia/tray-api-ai-plugin/tree/main/skills/visao-geral
Command: npx skills add https://github.com/tray-tecnologia/tray-api-ai-plugin --skill tray-visao-geral

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Este skill oferece uma visão geral reutilizável para integração com a API Tray, estabelecendo regras invariantes que devem ser aplicadas antes de qualquer skill de recurso.

Core Features & Use Cases

  • Regras invariantes de autenticação (OAuth como query param), estrutura de payload, expiração de tokens, rate limit e validação de dados brasileiros que regem todas as chamadas da API Tray.
  • Orientação para carregar a skill específica do recurso antes de gerar código e para validar payload com validate.mjs quando presente.
  • Caso de uso: iniciar uma integração carregando esta skill de visão geral e, em seguida, carregar a skill do recurso correspondente (por exemplo, produtos, pedidos) para implementar uma chamada completa da API.

Quick Start

Carregue esta skill geral de visão da API Tray primeiro e, em seguida, carregue a skill do recurso antes de criar código.

Frequently Asked Questions about tray-visao-geral

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authenticate Tray API requests using OAuth tokens?

Tray API authentication requires passing OAuth tokens as query parameters. This invariant rule standardizes all API calls, ensuring safe integration before loading resource-specific skills for payload execution.

What is the correct payload structure for Tray API integration?

Tray API payload structure requires standardized data formats, including validation for Brazilian data. Loading this overview skill enforces invariant payload rules before making resource-specific API calls.

How do I handle rate limits when making Tray API calls?

Tray API rate limits are enforced as invariant rules applied before resource-specific calls. Loading this overview skill standardizes rate limit handling and pagination across all integration workflows.

Do I need to load a specific resource skill before generating Tray API code?

Yes, Tray API integration requires loading the appropriate resource-specific skill after this overview skill. This ensures authentication, pagination, and payload rules are applied before generating code.

How do I validate Tray API payloads using validate.mjs?

Tray API payload validation uses an optional validate.mjs file when present in the resource skill. This overview skill guides loading the resource skill first, which then triggers payload validation.

Why are my Tray API webhooks not processing payloads correctly?

Tray API webhooks require standardized payload structures and Brazilian data format validation. Loading this overview skill applies invariant rules for payload structure and authentication before processing webhooks.