package
1.33.0-rc3
Repository: https://github.com/ovh/utask.git
Documentation: pkg.go.dev

# README

callback Plugin

This plugin allows to create callbacks. A callback can be created from a step using this plugin. Once the callback has been created, you can pause your resolution until the callback has been successfully called.

Configuration

FieldsDescription
action create to create a callback or wait to wait a callback
schemaonly valid if action is create: validate the body provided during the call of the callback
idonly valid if action is wait: ID of the callback to wait

Example

First, the callback has to be created:

create-cb:
  action:
    type: callback
    configuration:
      action: create
      schema: |-
        {
          "$schema": "http://json-schema.org/schema#",            
          "type": "object",
          "additionalProperties": false,
          "required": ["success"],
          "properties": {
            "success": {
              "type": "boolean"
            }
          }
        }

In a second step, you can wait for the callback resolution:

wait-cb:
  dependencies:
    - create-cb
  action:
    type: callback
    configuration:
      action: wait
      id: '{{field `step` `create-cb` `output` `id`}}'

Requirements

The base URl for callbacks must be defined in callback-config configuration key. The value must be a map with at least the base_url key which contains the base URL to reach the callback API from callers. You can also append a path_prefix key to override the default value (/unsecured/callback/).

Examples

In those examples, <ID> will be the callback ID and <T> the callback token.

Base URLPath prefixURL
https://foo.bar-https://foo.bar/unsecured/callback/<ID>?t=<T>
https://foo.bar/https://foo.bar/<ID>?t=<T>
https://foo.bar/foobar/https://foo.bar/foobar/<ID>?t=<T>

Return

Callback create action output

NameDescription
idThe public identifier of the callback
urlThe public URL of the callback
schemaThe sanitized schema

Callback wait action output

NameDescription
idThe public identifier of the callback
dateThe call date
bodyThe provided body during the call

# Functions

No description provided by the author
No description provided by the author
RotateEncryptionKeys loads all callbacks stored in DB and makes sure that their cyphered content has been handled with the latest available storage key.

# Constants

No description provided by the author
No description provided by the author
No description provided by the author

# Variables

No description provided by the author
No description provided by the author

# Structs

No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author